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Foreword 


Welcome to the world of microcomputers opened to you by your 
Motorola® 68000 microprocessor. Welcome also to the world of 
application software accessible through your Digital Research CP/M- 
68K™ operating system. Digital Research designed CP/M-68K 
especially for the Motorola 68000 MICEOPEOCeSnCr that is the heart 
of your computer. 


What CP/M-68K Does for You 


CP/M-68K manages and supervises your computer's resources, 
including memory and disk storage, the console (screen and 
Xeyboard), printer, and communications devices. It also manages 
information stored magnetically on disks by grouping this 
information into files of programs or data. CP/M-68K can copy files 
from a disk to your computer's memory, or to a peripheral device 
such as a printer. To do this, CP/M-68K places various programs in 
memory and executes them in response to commands you enter at your 
console. 


Once in memory, a program runs through a set of stepe: that 
instruct your computer to perform a certain task. You can use CP/M=- 
68K to create your own programs, or you can choose from the wide 
variety of CP/M-68K application programs that entertain you, educate 
you, and help you solve commercial and scientific problems. 


What You Heed to Run CP/M-68K on Your Computer 


The CP/M-68K operating system runs on Motorola's 68000 
microprocessor. You need that microprocessor, a console device 
(generally a keyboard and display device such as a CRT screen), and 
at least one floppy disk drive. To use all the capabilities of 
CP/M-68K, you should have two disk drives. At least one should be a 
Single density floppy drive compatible with the IBM 3740 diskette 
controller, because CP/M-68K and most CP/M applications are 
distributed on floppy disks suitable for this environment. 


CP/M-68K and its utility programs are distributed on five 
floppy disks. The system disk, labeled 1 of 5, contains the 
operating system and the most commonly used utility programs. The 
second disk, labeled 2 of 5, contains additional utilities. Disks 
3, 4, and § contain still more utilities, the C compiler, the C 
language library, files. which can be used to build versions of CP/M- 
68K adapted to custom hardware environments, and sample BIOSes. 
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How to Use CP/M-68K Documentation 


The CP/M-68K documentation set includes four manuals: 


@ CP/M~68K erating System User's Guide 
@ CP/M-68K erating System Programmer's Guide 
@ CP/M-68K erating System System Guide 


@ The C Programming Guide for CP/M-68K 


The CP/M-68K Operating System User's Guide introduces you to 
the CP/M-68K operating system and tells you how to use it. The 
User's Guide assumes that the version of CP/M-68K on your 
distribution disk is ready to run on your computer. To use this 
‘manual, you must be familiar with the parts of your computer, you 
must know how to set it up and turn it on, and you must know how to 
handle, insert, and store disks. However, you do not need a great 
deal of experience with computers. Z 


The CPA 68K Operating System Programmer's Guide presents 
information for application programmers who are creating or adapting 
programs to run under CP/M-68K. The Programmer's Guide includes 


information on the CP/M-68K assembler and debugger that experienced 
programmers use to create new CP/M-68K programs. 


The CP/M-68K Operating System System Guide describes the 
procedures required to adapt CP/M-68K for a custom hardware 
environment. 


The C Programming Guide for CP/M-68K contains information for 


programmers who wish to use the C compiler and C language library 
included with CP/M-68K. 


How the User's Guide is Organized 


This guide begins with simple examples, proceeds with basic 
concepts, then presents a detailed reference section on commands. 
The first four sections describe CP/M-68K operation for the first- 
time user. 


Section 1 introduces CP/M~68K and tells you how to start the 
operating system, enter commands, edit the command line, and create 
a back-up copy of your distribution disks. Section 2 discusses 
files, disks, and drives. Section 3 describes how you can use CP/M- 
68K to manage your printer and console. 


Section 4 develops the concepts you need to use CP/M-68K 
commands. If you are new to CP/M, read the first four sections 
carefully to get a general understanding of how to use CP/M-68K 
before you proceed to the specific command descriptions. 
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Section 5 provides detailed information on each CP/M-68K 
utility program, arranged alphabetically for easy reference. 
Section 6 tells you how to use ED, the CP/M-68K file editor. With 
ED, you can create and edit program, text, and data files. 


Appendix A lists the messages CP/M-68K displays when it 
encounters special conditions, and describes corrective action where 
necessary. Appendix B provides an ASCII to hexadecimal conversion 
table. Appendix C lists the filetypes associated with CP/M-68K. 
Appendix D lists and defines the CP/M-68K control characters. 


Appendix E provides a simple glossary of commonly-used computer 


terms. a 


If you are new to computers, you might find some of the topics 
a bit difficult to understand at first. Learning to use your 
computer is a challenge, and we hope you will find it fun. This 
book proceeds step by step so that you can quickly proceed from 
opening your new system disk package to using CP/M-68K's powerful 
facilities. 
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Section 1 
Introduction to CP/M-68K 


This section tells you how to start CP/M-68K, how to enter a 
command and edit the command line, and how to make a back-up copy of 
your CP/M-68K distribution disks. 


1.1 How to Start CP/M-68K 


Starting or loading CP/M-68K means reading a copy of the 
operating system from your CP/M-68K system disk (1 of 5 of your 
distribution disks) into your computer's memory. This is called a 
boot or cold start. Because the boot process varies from computer 
to computer, you must follow the manufacturer's instructions for the 
computer you use. Described in the next two paragraphs is a 
typical, but not universal, booting process. 


First, be sure your computer's power is on. Next, insert the 
CP/M-68K system disk into your initial drive. In this section, 
assume that the initial drive is A and the disk is removable. Close 
the drive door. Then, press the RESET or RESTART button. . This 
automatically loads CP/M-68K into memory. , 


If you want to restart CP/M-68K at some point after the initial 
loading of the system, first make sure your CP/M-68K system disk is 
in your initial drive then press the RESET or RESTART button. This 
is called system reset. It has the same effect as pressing RESET or 
RESTART when you first power up your computer. If you do a system 
reset after you have powered up, any data that is in your computer's 


- memory prior to the system reset is erased. This means that any 


data that is not stored on a disk is lost. 


After CP/M-68K is loaded into memory, the following message is 
displayed on your screen: 


CP/M-68K Version V.V 
Copyright(c) 1983 Digital Research Inc. 


The version number, represented above by V.V, tells you the version 
of CP/M-68K that you own. After this display, the following two-. 
character message appears on your screen: 


A> 


This is the CP/M-68K system prompt. The system prompt tells 
you that CP/M-68K is ready to read a command from your keyboard. In 
this example, the prompt also tells you that drive A is your default 
drive. This means that until you teil CP/M-68K to do otherwise, it 
looks for program and data files on the disk in drive A. 
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CP/M-68K User's Guide 1.2 The Command Line 


1.2 The Command Line 


CP/M-68K performs certain tasks according to specific commands 
that you type at your keyboard. A CP/M-68K command line is composed 
of a command keyword, an optional command tail, and a RETURN 
keystroke. The command keyword identifies a command (program) to be 
executed. The command tail can contain extra information for the 
command, such as a filename or parameters. To end the command line, 
you must press the RETURN key. Note that the RETURN key can be 
marked ENTER, RETURN, CR, or something similar on your keyboard. In 
this guide, RETURN signifies the RETURN key. 


As you type characters at the keyboard, they appear on your 
screen. The single-character position indicator, called the cursor, 
moves to the right as you type characters. If you make a typing 
mistake, press either the BACKSPACE key (if your keyboard has one) 
er CTRL-H to move the cursor to the left and correct the error. 
CTRL is the abbreviation for the CONTROL key. To type a control 
character, hold down the CTRL key and press the required letter key. 
For example, to move the cursor to the left, hold down CTRL and 
press the H key. 


You can type the keyword and command tail in any combination of 
upper-case and lower-case letters. CP/M-68K treats all letters in 
the command line as upper-case. 


Generally, you type a command line directly after the system 
prompt. However, CP/M-68K does allow spaces between the prompt and 
the command keyword. 


Let's usé one command to demonstrate how CP/M-68K reads command 
lines. The DIR command tells CP/M~68K to give you a directory of 
the names of disk files on your screen, while the DIRS command 
displays only the system files. Type the DIRS keyword after the 
system prompt, omit the command tail, and press RETURN. 


A>DIRS 


CP/M-68K responds to this command by writing the names of those 
files that are stored in the default storage area. For discussion 
of storage areas, refer to Section 2.4. For example, if you have 
your CP/M-68K system disk in the default drive A, these filenames, 
among others, appear on your screen: 


STAT 68K 
PIP 68K 


CP/M-68K takes the command keyword exactly as you type it and 
compares your input to executable program files in the CP/M-68K 
directory. I£ the command keyword matches a program file in the 
directory, CP/M-68K executes that program. If the first word you 
typed does not match any file in the directory, CP/M-68K echoes this 
unmatchable command keyword and puts a queStion mark after it. For 
example, if you mistype the DIRS command, CP/M-68K responds 


A>DJRS 
DJRS? 


to tell you that it can not find the command keyword. To correct 
Simple typing errors, use the BACKSPACE key, or hold down the CTRL 
key and press H to move the cursor to the left. You cannot correct 
typing errors after you press the RETURN key. The command must then 
be typed correctly in its entirety. CP/M-68K supports other control 
characters that help you edit command lines efficiently. Section 3 
tells how to use control characters to edit command lines and other 
information you enter at your console. 


DIRS accepts a filename as a command tail. . You can use DIRS 
with a filename to see if a specific file is on the disk. For 
example, to check that the transient utility program COPY.68K is on 
your system disk, type 


A>DIRS COPY.68K 


CP/M-68K performs this task by displaying either the name of the 
file you specified, or the message, No File. 


Be sure to type at least one space after DIRS to separate the 
command keyword from the command tail. I£ you do not, CP/M-68K 
responds as shown. 


A>DIRSCOPY . 68K 
DIRSCOPY .68K? Bs 


1.3 Why You Should Back Up Your Files 


Human or computer errors sometimes destroy valuable programs or 
data files. By mistyping a command, for example, you could 
accidentally erase a program that you just created or a data file 
that has been months in the making. A similar disaster could result 
from an electronic component failure. 


Data processing professionals avoid losing programs and data by 
making copies of valuable files. Always make a working copy of any 
new program you purchase and save the original. If the program is 
accidentally erased from the working copy, you can easily restore it 
from the original. 


It is also wise to make frequent copies of new programs or data 
files as you develop them. The frequency of making copies varies 
with each programmer. As a-general rule, make a copy at the point 
where it takes ten to twenty times longer to reenter the information 
than it takes to make the copy. 


Note: If you suspect a hardware problem has interfered with your 
copying, do not use your valuable backup disk to restart or continue 
the copy process. Hardware problems have an even greater potential 
for harm to your disks than software problems do. If you need to 
locate a hardware problem, please use non-critical disks. 
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CP/M~68K User's Guide 1.3 Why You Should Back Up Your Files 


So far, we have not discussed any commands that change 
information recorded on your CP/M-68K system disk. Before we do, 
let's make a few working copies of the your distribution disks. 


1.4 How to Make Copies of Your CP/M-68K Disks 


To back up your CP/M-68K disks, you need several floppy disks. 
The back-up disks can be factory-fresh or used. You might want to 
format new disks or reformat used disks with the disk formatting 
program that accompanies your particular computer. If the disks are 
used, make sure that there are no files on the disk that you want to 
save. 


If your computer's manufacturer has provided a special program 
to copy disks, you might use that program to make back-ups of your 
distribution disks. Otherwise, you can use the COPY utility program 
that comes with your set of CP/M-68K distribution disks. COPY is a 
track-by-track disk copying and formatting program that can copy the 
operating system loader and utility programs from your system disk. 
COPY creates a complete and exact copy of your system disk. 


To use the COPY utility, simply type COPY and press the RETURN 
key. The following message comes on the screen: 


COPY VER 1.1 


followed by a mode menu: 


MODE FUNCTION 

ALL Copy the whole disk 

BOOT Copy the boot tracks only 
PILES Copy the files only 

END End the program 


Once you have selected your mode, type it in and press RETURN. The 
following prompt appears on the screen: 


Enter SOURCE drive: ad 


You must then type a drive letter from A to P and press RETURN. The 
program then prompts you to 


Enter DESTINATION drive: _ 


Again, you must select a drive letter, and press RETURN. Then the 
program gives you a chance to abort the process by prompting: 


(“C to ABORT) 
RETURN to copy <mode> from <source> to <destination> 


Say SMBS ON OSE 
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CP/M-68K User's Guide 1.4 How to Copy Your CP/M-68K Disks 


The program gives you a chance to review what you have selected 
before proceeding. If you still want to proceed, press the RETURN 
key. If not, hold down the control key while pressing C and the 
process will be terminated. For an expanded treatment of the COPY 
utility, see Section 5, Command Summary. 


~ 


End of Section 1 
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Section 2 
Files, Disks, and Drives 


CP/M-68K's most important task is to access and maintain files 
on your disks. With CP/M-68K you can create, read, write, copy, and ~ 
erase disk files. This section tells you what a file is, how to 
create, name, and access a file, and how files are stored on your 
disks. It also tells how to change disks and change the default 
drive. 


2.1 What is a File? 


A CP/M-68K file is a collection of related information stored 
on a disk. Every file on a given disk must have a unique name 
because CP/M-68K uses that name to access that file. A directory is 
also stored on each disk. The directory contains a list of the 
files stored on that disk and the locations of each file on the 
disk. 


In general, there are two kinds of files: program (command) 
files and data files. A program file is an executable file, a 
series of instructions the computer can follow step by step. A data 
file is usually a collection of information: a list of names and 
addresses, the inventory of a store, the accounting records of a 
business, the text of a document, or similar related information. 
For example, your computer cannot execute names and addresses, but 
it can execute a program that prints names and addresses on mailing 
labels. 


A data file can also contain the source code for a program. 
Generally, a program source file must be processed by an assembler 
or compiler before it becomes a program file. In most cases, an 
executing program processes a data file. However, there are times 
when an executing program processes a program file. For example, 
the copy program PIP can copy one or more program files. 
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2.2 How are Files Created? 


There are many ways to create a file. You can create a file by 
copying an existing file to a new location, perhaps renaming it in 
the process. Under CP/M-68K, you can use the PIP command to copy 
and rename files. A second way to create a file is to use a text 
editor. The CP/M~68K text editor ED, described in Section 6, can 
create a file and assign it the name you specify. Finally, some 
programs such as AS68™ create output files as they process input 
files. P 
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2.3 Baming Files--What's in a Name? 


CP/M-68K identifies every file by its unique file 
specification. The simplest kind of file specification is a one- to 
eight-character filename, such as: 


MYFILE 


A file specification can have up to three parts: a drive 
specifier, a filename, and a filetype. 


The drive specifier is a single letter (A-P) followed by a 
colon. Each drive in your system is assigned a letter. When you 
include a drive specifier as part of the file specification, you are 
telling CP/M-68K that the file is stored on the disk currently in 
that drive. For example, if you enter 


B:MYFILE 
CP/M-68K looks in drive B for the file MYFILE. 


The filename can be from one to eight characters. When you 
make up a filename, try to let the name tell you something about 
what the file contains. For example, if you have a list of customer 
names for your business, you could name the file 


CUSTOMER 


so that the name is eight or fewer characters, and gives you some 
idea of what is in the file. . 


As you begin to use your computer with CP/M-68K, you will find 
that files fall naturally into categories. To help you identify 
files belonging to the same category, CP/M-68K allows you to add an 
optional one- to three~character extension, called a filetype, to 
the filename. When you add a filetype to the filename, separate the 
filetype from the filename with a period. Try to use three letters 
that tell something about the file's category. For example, you 
could add the following filetype to the file that contains a list of 
customer names: 


CUSTOMER .NAM : ee 


When CP/M-68K displays file specifications in response to a 
directory or DIR command, it adds blanks to short filenames so that 
you can compare filetypes quickly. 


The program files that CP/M-68K loads into memory from a disk 
have different filetypes, but are in the category of 68000 and 
equivalent programs that run with CP/M-68K. The filetypes .68K and 
-REL identify this category of executable programs. 


We recommend that you create file specifications from letters 
and numbers. You must not use the following characters in filenames 
or filetypes because they have special meanings for CP/M-68K: 
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A complete file specification containing all possible elements 
consists of a drive specification, a primary filename, and a 
filetype, each separated from the other by its appropriate 
delimiter, as shown in the following example: 


A: DOCUMENT . LAW 


2.4 Accessing Files--Do You Have the Correct Drive? 


When you type a file specification: in a command tail without a 
drive specifier, the built-in or transient utility looks for the 
file in the drive named by the system prompt, called the default 
drive. For example, if you type the command 


A>DIR COPY. 68K 


DIR looks in the directory of the disk in drive A for COPY.68K. If 
you have another drive, B for example, you need a way to tell CP/M- 
68K to access the disk in drive B instead. For this reason, CP/M- 
68K lets you precede a filename with a drive specifier. Por 
example, in response to the command 


A>DIR B:MYFILE.LIB 


CP/M-68K looks for the file MYFILE.LIB in the directory of the disk 
in drive B. When you give a command to CP/M-68K, you should note 
which disk is in the default drive. Many application programs 
require that the data files they access be stored in the default 
drive. 


You can also precede a program filename with a drive specifier, 
even if you use the program filename as a command keyword. For 
example, if you type the following command: 


A>B: PIP 


CP/M-68K looks in the directory of the disk in drive B for the file 
PIP.68K. If CP/M-68K finds PIP on drive B, under user 0, it loads 
PIP into memory and executes it. 


If you need to access many files on the same drive, you might 
find it convenient to change the default. drive so that you do not 
need to enter a drive specifier repeatedly. To change the default 
drive, simply enter the drive specifier next to the system prompt. 
In response, CP/M-68K changes the system prompt to display the new 
default drive: 
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A>B;: 
B> 


Because the drive specifier is part of a file's file 
specification, moving a disk to a different drive changes the file 
‘specifications of the files on that disk. Keep this in mind when 
moving disks from one drive to another. ; 


Section 4 presents more information on how CP/M-68K locates 
program and data files. 


2.5 Accessing Files--Do You hawe the Correct User Number? 


CP/M-68K further identifies all files by assigning each file a 
user mumber, in the range from 0 to 15, when the file is created. 
fhe user number for each file is recorded in the disk directory. 
User numbers allow you to separate your files into sixteen file 
groups. User numbers are particularly useful for organizing hard 
disk space. 


When you use a CP/M-68K utility to create a file, the file is 
assigned to the current user number, unless you use PIP to copy the 
file to another user number. You can determine the current user 
number by looking at the system prompt. 


4A> User number 4, drive A 
A> User number 0, drive A 
2B> User number 2, drive B 


The user number always precedes the drive identifier in the system 
prompt. User 0, however, is the default user number and is not 
displayed in the prompt. 


You can use the built-in command USER to change the current 
user number. 


A>USER 3 
3A> 


Most commands can access only those files that have the current 
user number. For example, if the current user number is 7, a DIR 
Command displays only the files that were created under user number 
7. However, if an executable program file or a SUBMIT file resides 
in user 0, the file can be accessed from any user number, in case it 
does not already exist in the current user area. 


2.6 Accessing More Than One File 


Certain CP/M-68K built-in and transient utilities can select 
and process several files when special wildcard characters are 
included in the filename or filetype. A file specification 
containing wildcards can refer to more than one file because it 
gives CP/M-68K a pattern to match. CP/M-68K searches the disk 


zs) 
ts 
wm 
at 

(hh 
' 
tt 
q 
si 
ie) 
i) 
A 
tf 
i—J 
tn 
ty 
ry 
1@) 
iB) 
Le | 
' 

p 
tt 
1 
Un 
c 

f 

' 

£ 
’ 

, 

{ 

U 

yy! 
sf 
a 
wD 
t 

t¢ 
GO 


All Inicrm2t.07 


IN a TR EGP FETE eam FO 


CP/M-68K User's Guide 2.6 Accessing Multiple Files 


directory and selects any file whose filename or filetype matches 
the pattern. 


The two wildcard characters are ?, which matches any single 
letter in the same position, and *, which matches any character at 
that position, and any other characters remaining in the filename or 
filetype. The following list presents the rules for using 
wildcards. 


@A ? matches any character in a name, including a space 
character. 


@ An * must be the last, or only, character in the filename or 
filetype. CP/M-68K internally replaces an * with ? characters 
to the end of the filename or filetype. 


@ When the filename to match is shorter than eight characters, 
CP/M-68K treats the name as if it ends with spaces. 


@ When the filetype to match is shorter than three characters, 
CP/M-68K treats the filetype as if it ends with spaces. 
Suppose, for example, you have a disk that contains the 

following six files: 


A.68K, AA.68K, AAA.68K, B.68K, A.REL, and B.REL 


The following wildcard specifications match all, or a portion of, 
the preceding files: 


7% - is treated as ?22722272?.2?? 
22222222.222? #+$=$matches all six names 

*.68K is treated as ??722727?7?.68K 

2222222? .68K matches the first four names 

?.68K matches A.68K and B.68K 

(sd is treated as ?.??? 

2.2?? matches A.68K, B.68K, A.REL, and B.REL 
A? .68K matches A.68K and AA.68K 

A* .68K is treated as A???????.68K 


A2?222227?.68K matches A.68K, AA.68K, and AAA.68K 
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Remember that CP/M-68K uses wildcard patterns only while 
searching a disk directory, and therefore wildcards are valid only 
in filenames and filetypes. You cannot use a wildcard character in 
a drive specifier. 


2.7 File Attributes 


When you create a file, CP/M-68K gives it two attributes: DIR 
(for DIRectory) and R/W (for Read-Write). Through the STAT command, 
you can change these attributes from DIR to SYS (for S¥Stem) and 
from R/W to R/O (for Read-Only). 


DIR and SYS attributes control whether CP/M-68K displays the 
file’s name in response to a DIR command or DIRS command. DIR 
displays only the file specifications having the DIR attribute; DIRS 
displays only the file specifications having the SYS attribute. 


. fhe second file attribute can be set to either R/W (Read-Write) 
or R/O (Read-Only). If a file is marked R/O, any attempt to write 
Gata to that file produces a Read-Only error message. Therefore, 
you can use the R/O attribute to protect important files. A file 
with the R/W attribute can be read or written to at any time, unless 
you inadvertently switch disks during execution of a program. 


2.8 How are Files Stored on a Disk? 


CP/M~-68K records the filename, filetype, user number, and 
attributes of each file in a special area of the disk called the 
directory. In the directory, CP/M-68K also records which parts of 
the disk belong to which file. You can use the STAT command to 
determine the number of entries in your directory. 


CP/M-68K allocates directory and storage space for a file as 
records are added to the file. When you erase a file, CP/M-68K 
reclaims storage in two ways: it makes the file's directory space 
available to catalog a different file, and it frees the file's 
storage space for later use. This handling of storage and directory 
space, called dynamic file allocation, is a powerful feature of 
CP/M-68K. You do not have to tell CP/M-68K how big your file will 
become, because it automatically allocates more storage for a file 


as needed, and releases the storage for reallocation when the file 


is erased. Use the STAT command to determine how much space remains 
on the disk. 


2.9 Changing Floppy Disks 
CP/M-68K cannot, of course, do anything to a file unless the 
disk that holds the file is inserted into a drive and the drive is 


ready. When a disk is in a drive, it is on-line and CP/M-68K can 
access its directory and files. 
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At some time, you will need to take a disk out of a drive and 
insert another that contains different files. You can replace an 
on-line disk whenever you see the system prompt at your console. 
This is a clear indication that no program is reading from or 
writing to the drive. 


you can also remove a disk and insert a new one when an 
application program prompts you to do so. This can occur, for 
example, when the data that the program uses does not fit on one 
floppy disk. Note that you must never remove a disk if a program is 
reading from or writing to it. See the CP/M-68K Programmer's Guide 
for more information on disk handling. 


End of Section 2 
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Section 3 
Console and Printer 


This section describes how CP/M~68K communicates with your 
console and printer. It tells how to start and stop console and 
printer output, edit commands you enter at your console, and. 
redirect console and printer input and output. It also explains the 
concept of logical devices under CP/M-68K. 


3.1 Controlling Console Output 


Sometimes CP/M-68K displays information on your screen too 
quickly for you to read it. Sometimes an especially long display 
scrolls off the top of your screen before you have a chance to study 
it. To ask the system to wait while you read the display, hold down 
the CTRL key and press S. A CTRL-S keystroke causes a pause in the 
display. When you are ready, press CTRL-Q to resume the display. 


3.2 Controlling Printer Output 


You can also use a control command to echo console output at 
the printer, if you have one. To start printer echo, enter a CTRL- 
P. To stop printer echo, enter another CTRL-P. While printer echo 
is in effect, any characters that appear on your screen are listed 
at your printer. : 


You can use printer echo with a DIR command to make a list of 
files to store on a floppy disk. You can also use CTRL-P with CTRL- 
S and CTRL-Q to make a hard copy of part of a file. Use a TYPE 
command to start the a display of the file at the console. When the 
display reaches the part you need to print, press CTRL-S to stop the 
display, CTRL-P to enable printer echo, and then CTRL-Q to resume 
the display and start printing. You can use another CTRL-S, CTRL-P, 
CTRL-~Q sequence to terminate printer echo. 


3-3 Console Line Editing 


You can correct simple typing mistakes in the command line with 
the BACKSPACE or CTRL-H key. CP/M-68K also supports additional 
line-editing functions that you perform with control characters. 
You can use the control characters to edit command lines or input 
lines to most programs. 


CP/M-68K allows you. to edit your command line using the set of 
characters listed in Table 3-1. To edit a command line in CP/M- 
68K, use control characters to delete characters left of the cursor, 
then replace them with new Characters. . 
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In the following example command line, the command keyword PIP 
is mistyped. The underbar represents the cursor. 


A>POP A:=B:*.*_ 


To move the cursor to the letter 0, hold down the CTRL key and press 
the letter H eleven times. CTRL-H deletes characters as it moves Re 
the cursor left, leaving the following command line: 


A>P 


Now you can type the correct letters, press RETURN, and send 
the command to CP/M~-68K. 


A>PIP A:=B:*.*_ 


Table 3-1 lists all line-editing control characters for CP/M- 
68K. 


Table 3-1. CP/M-68K Line-editing Control Characters 


Porces a physical RETURN but does not send 
the command line to CP/M-68K. Moves the 
cursor to the beginning of the next line 
without erasing your previous input. 


Deletes a character and moves the cursor 
left one character position. Has the same 
function as backspace. 


Moves the cursor to the next tab stop. Tab 
stops are automatically set at each eighth 
colum. Has the same effect as pressing the 
TAB key. 


Sends the command line to CP/M-68K and 
returns the cursor to the left of the 
current line. Bas the same effect as a 
RETURN or a CTRL-M. 


Sends the command line to CP/M-68K and 
returns the cursor to the left of the 
current line. Has the same effect as a 
RETURN or a CTRL-J. 


Places a # at the current cursor location, 
moves the cursor to the next line, and 
displays any partial command you typed so 
far. Pressing RETURN sends the command to 
CP/M-68K. 
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Table 3-l. (continued) 


Discards all the characters in the command 
line, places a # at the current cursor 
position, and moves the cursor to the next 
command line. 


Discards all the characters in the command 
line, and moves the cursor to the beginning 
of the current line. 


You probably noticed that some control characters have the same 
meaning. For example, the CTRL-J and CTRL-M keystrokes have the 
same effect as pressing the RETURN key; all three send the command 
line to CP/M-68K for processing. Also, CTRL-H has the same effect 
as pressing the BACKSPACE key. 


3.4 Assigning Logical Devices 


Most CP/M-68K computer systems have a traditional console with 
a keyboard and screen display. Many also have letter-quality 
printers. I£ you use your computer for unusual tasks, you might 
want to add a different kind of character device to your system: a 
line printer, a teletype terminal, a modem, or even a joystick for 
playing games. To keep track of these physically different input 
and output devices, CP/M-68K associates different physical devices 
with logical devices. When you receive your CP/M-68K system, the 
legical devices are assigned to physical devices as shown in Table 
3~2. 


Table 3-2. CP/M-68K Logical Devices 
rogicat tam 
Console input Keyboard 
Console output Screen | 


Auxiliary input Auxiliary input port 
‘ (if one exists) 


Auxiliary output Auxiliary output port 
(if one exists) 


List output Printer 
(if one exists) 
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The assignment of logical names to physical devices is done by 
the hardware manufacturer. Sowever, in some implementations of 
CP/M-68K, you can change these assignments with the STAT command. 
For example, you can assign AUXI and AUXO to a modem so that your 
computer can communicate with others over the telephone. The 
section on STAT in the Command Summary, Section 5, describes how to 
accomplish this. 


End of Section 3 


Section 4 
CP/M-68K Command Concepts 


As we discussed in Section 1, a CP/M-68K command line consists 
of a command keyword, an optional command tail, and a RETURN 
keystroke. This section describes the two kinds of programs the 
command keyword can identify, and tells how CP/M-68K searches for a 
program file on a disk. It also tells how to execute multiple CP/M- 
68K commands, and how to reset the disk system. 


4.1 Two Kinds of Commands 


A command keyword identifies a program that resides either in 
memory as part of CP/M-68K, or on a disk as a program file. 
Commands that identify programs in memory are called built-in 
commands. Commands that identify program files on a disk are called 
transient utility commands. . 


Seven built-in commands and several transient utility commands 
are tncluded with CP/M-68K. You can add utilities to your system by 
purchasing various CP/M-68K-compatible application programs. If you 
are an experienced programmer, you can also write your own utilities 
that operate with CP/M-68K. 


4.1.1 Built-in Commands 


Built-in commands are part of CP/M-68K and come into memory 
when you boot the system. Because they reside in memory, built-in 
commands have two advantages over transient commands: 


@ Built-in commands are always available regardless of the 
current user area or default drive displayed in the command 


prompt. 
e@e Built-in commands start executing more quickly than the 


transient utilities because they do not have to be read froma 
disk. 


Section 5 gives you the operating details of the built-in 
commands listed in Table 4-1. . 
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fable 4-1. Built-in Commands 


DIR - Displays filenames of files marked with the DIR 
(DIRectory) attribute in the directory. 


Displays filenames of files marked with the SYS 
(SYStem) attribute in the directory. 


Erases a file from the disk by removing the 
filename from the directory and by releasing 
the storage space occupied by the file. 
REN. Renames a disk file. 


SUBMIT Executes a list of commands contained in a 
SUBMIT file that you create. 


TYPE Displays contents of an ASCII (character) file 
at your screen. 


USER Changes to a different user number. 


CP/M-68K .does not allow you to abbreviate the built-in 
commands. 


4.1.2 Transient Utility Commands 


A transient utility command executes a program that comes into 
memory only when you request it. When you enter a command keyword 
that identifies a tansient utility, CP/M-68K loads the program file 
from the disk and passes it any filenames, data, or parameters you 
entered in the command tail. Because these programs are loaded from 
disk, the disk with the program file must be accessable to execute 
the command. See Section 4.2 for an explanation of how CP/M-68K 
searches for command files. 


Section 5 provides the operating details for the most 
frequently used CP/M-68K transient utilities listed in Table 4-2. 
Less frequently used utilities are described in the CP/M-68K 
Programmer's Guide. Many of these utilities are programming tools 
you might never need to use, however they are mentioned in Table 4- 
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Table 4-2. 


Stores object files in the 
- C run-time library: the 
_ Archive utility. 


Invokes the assembler. 
Invokes a submit file for 
calling the C language compiler. 


Intermediate compiling steps 
for the C language. 


Intermediate compiling steps 
for the C language. 


Invokes the C Language Pre- 
processor for processing macros. 


Copies disks (including CP/M-68K 
boot disks). 


Invokes DDT™, the CP/M-68K 
debugger. 


Displays a file in ASCII and 
hexadecimal formats. 


Creates and alters character 
files. 


Marks all disk sectors with the 
appropriate density and length. 


Prepares a disk so that CP/M-68K 


can write on it. INIT erases 
any files and directory entries 
that are on the disk prior to 
execution. 


Invokes the Linker. 


Invokes the NM68 utility 
that prints the symbol table. 
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fable 4-2. (continued) 


PIP Copies, combines, or transfers CP/M-68K User's 
specified files between Guide, Section 5 
peripheral devices. 


Relocates a command file CP/M~68K 
containing relocation information Programmer's Guide . 
to an absolute address. 


SENDC68 Converts a command file to the . CP/M-68K 
Motorola S-record format.: Programmer's Guide 


SIZE68 Prints the size of a command CP/M~68K 
file. Programmer's Guide 


STAT Shows the access status for CP/M-68K User's 
disks or files, the amount of Guide, Section 5 
free spaceon disks, the space 
occupied by files, or the 
logical-to-physical assignment 
ef devices, according to options 

specified in the command line. _ 


4.2 How CP/M-68K Searches for Program and Data Files 


This section describes how CP/M-68K searches for program and 
data files on disk. You need to understand the steps CP/M-68K 
follows, especially. if it appears that CP/M-68K cannot find a 
program file you specified with a command keyword in a command line. 
If, for example, you have more than one disk drive on your system, 
the problem might be that CP/M-68K is not looking on the drive where 
the file is stored. 


4.2.1 Finding Data Files 


As you recall, when you enter a command line CP/M~68K passes 
the command tail to the program identified by the command keyword. 
If the command tail contains a file specification without a drive 
specification, the program asks CP/M-68K to search for the data file 
on the default drive and current user area. 


For example, if you enter the following command line: 
3A>DIR MYFILE.TAT 
then CP/M-68K limits its search to user 3, drive A. If MYFILE.TXT 
has the DIR attribute and exists in user 3, drive A, CP/M-68K 


confirms the file's existence by displaying the filename on your 
screen: 
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A:MYFPILE .TAT 


Note that the user number does not appear in the directory 
listing. DIR also reports, System Files Exist, if user 3, drive A, 
contains files marked with the SYS attribute. 


If MYFILE.TXT has the SYS attribute and exists in user 3, drive 
A, DIR merely reports that, System Files Exist; the filename 
MYFILE.TXT is not echoed to the screen. 


Whether a data file is marked SYS or DIR, the search for a data 
file does not extend beyond the current user area and current drive. 
If CP/M-68K cannot find the data file, the program displays an error 
message at the console. Typically, this message is, File not found, 
or, No File; which message appears depends on the program identified 
by the command keyword. 


4.2.2 Pinding Program Files 


When searching for a command file, CP/M-68K uses an extensive 
Search pattern. This search is based on your command keyword and 
filetype which you may or may not supply. 


If you add a filetype to your command keyword, CP/M-68K first 
searches the current user area for the command file with that 
filetype. If it cannot find the file in the current user area, 
CP/M-68K searches user area Q. for the command file having the 
filetype you supplied. 


If you omit a filetype to your command keyword, CP/M-68K tries 
to supply one for you based on the following search pattern: 


e@ CP/M~68K first checks the current user area and drive to see if 
there is a program file with your command keyword as its name 
and 68K as its filetype. If it does not, CP/M-68K then checks 
to see if it has a blank filetype. If the filetype is neither 
68K nor blank, CP/M-68K then checks to see if the program file 
has a filetype of SUB. 


e If the program file has none of these filetypes in the current 
user area, then CP/M-68K checks user area 0 for the same search 
pattern: first for the 68K filetype, then for the blank 
filetype, and finally for the SUB filetype. 


@ At any point in the search process, CP/M-68K stops the search 
if it finds the program file. CP/M-68K then loads the program 
into memory and executes it. When the program terminates, 
CP/M-68K displays the system prompt and waits for your next 
command. 


e If CP/M-68K does not find the command file, it repeats the 
command, follows it with a question mark, and waits for your 
next command. 
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If you include a drive specifier before the command keyword, 
CP/M-$8K first looks for the program file on the specified drive in 
the current user area. If the program file is not found there, 
CP/M-68K searches user area 0 on the same drive. The search goes no 
further than this when a drive specifier is included in the command 
keyword. 


4.3 Executing Multiple Commands 


In the examples used so far, CP/M-68K has executed only one 
command at a time. CP/M-68K can also execute a list of commands. 
You can enter a list of commands at the system prompt, or ou can 
put a frequently needed list of commands in a disk file. Once you 
have stored the list in a disk file, you can execute the list 
whenever you need to with a SUBMIT command. 


To list multiple commands on the command line, separate each 
command keyword and command tail from the next keyword with an 
exclamation point. When you complete the list, press RETURN. CP/M- 


‘68K executes your commands in sequence, as shown below: 


3A>dirsidir examp*.*!stat a: 
CP/M-68K responds to the first of your three commands by repor ting 
NON-SYSTEM FILE(S) EXIST 


Without waiting for any operator intervention, CP/M~68K executes the 
second command: 


3A>dirc examp*.* 
A: EXAMP7 : 
A: EXAMPS : EXAMP6 


Finally it executes the third command in the. series: 
3A>Stat a: 
A: RW, Free Space: 98k 


If you find you need to execute the same command list 
frequently, store the list in a disk file. See the description of 
the SUBMIT command in Section 5 for how to repeatedly execute a list 
of commands. 


4.4 Terminating Programs 


There might be times when you want to terminate a running 
program before it terminates itself. You can terminate the DIR, 
DIRS, TYPE, and SUBMIT built-in commands and all transient 
utilities, supplied with CP/M-68K whether invoked singly or in a 
multiple command line, simply by holding down the control key .as 
FM EE elie een ons 


EXAMP1 TXT : EXAMP3 : EXAMP2 TXT : EXAMP4 


you press the C key. On many keyboards, the word control is 
abbreviated to CTRL. In addition, a CTRL-C can terminate many of the 
application programs that you run with your CP/M-68K operating 
system. 


You enter a CTRL-C during program execution as the first 
character after the system prompt. CTRL-C does ndt work, for 
- example, at the end of a command line, before you press RETURN. 


If you try to abort a program other than DIR, DIRS, TYPE, or 
SUBMIT, you might experience a delay between the time you press 
CTRL-C and the time the program terminates because because CP/M~68K 
checks CTRL-C only when reading from or writing to the console. 


When you press CTRL-C during a program's execution CTRL-C 
causes a warm Start, sometimes called a warm boot. Unlike other 
versions of CP/M, a warm start in CP/M-68K does not reload the 
operating system from your disk back into your computer's memory; 
CP/M-~68K is always resident in memory. In CP/M-68K, a warm start 
does two things: it empties that portion of memory occupied by 
transient utilities and application programs, and it also resets all 
drives to a Read-Write state. At the end of a normal program 
execution of a transient utility or a built-in command, CP/M-68K 
performs a warm start. 


f 
4.5 Pacts of a File Specification | 
This section describes the three parts of a file specification 
in a command line. To avoid confusion, each part is given a formal 
name. The three parts of a file specification are as follows: 


e drive specifier--the optional disk drive A, B, C, ..., P that 
contains the file or group of files to which you are referring. 
If a drive specifier is included in your command line, a colon 
must follow it. 


e filename--the one- to eight-character first name of a file or 
group of files. 


@ file type--the optional one- to three~character category name of 
a file or group of files. If the filetype is present, a period 
must separate it from the filename. 


If you do not include a drive specifier, CP/M-68K automatically 
‘uses the default drive. If you omit the period and the filetype, 
CP/M-68K automatically includes a filetype of three blanks. 


This general form is called a file specification. A file 
specification names a particular file or group of files in the 
directory of the on-line disk given by the drive specifier. For 
example, 

B:MYPILE.DAT 
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is a file specification that indicates drive B:, filename MYFILE, 
and filetype DAT. File specification is abbreviated to simply 


filespec 
in the command syntax statements in Secti6n 5. 


Some CP/M-68K commands accept wildcards in the filename and 
filetype parts of the command tail. For example, 


B:MY* .A?? 


is a file specification with drive specifier B:, filename MY*, and 
filetype A??. This file specification might match several files in 
the directory. 


Put together, the parts of a file specification are represented 
like this: . 


d:filename. typ 


In the above form, d: represents the optional drive specifier, 
filename represents the one- to eight-character filename, and typ 
represents the optional one- to three-character filetype. The 
syntax descriptions in this section use the term filespec to 
indicate any valid combination of the elements included in the file 
specification. The following list shows valid combinations of the 
elements of a CP/M-68K file specification. 


e filename 

e filename.typ 
e d: filename 

@ d:filename.typ 


The characters in Table 4-3 have special meaning in CP/M-68K, 
so do not use these characters in a file specification except as 
indicated. 
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Table 4-3. Command Line Delimiters 


me file specification delimiters 
tab 1 ae 
RETURN keystroke 
drive delimiter in file specification 
filetype delimiter in file specification 


option list delimiters, reserved for 
future use ' 


command separator 


option list delimiters for global and 
local options 


comment delimiter at the beginning of a 
command line 


CP/M-68K has already established several file groups. Table 4- 
4 lists some of their filetypes with a short description of each 
family. Appendix B provides the complete list. 


Table 4-4. CP/M-68K Filetypes 
assembler source file 
68000 or equivalent machine language program 
relocatable executable program file 


C language source file 


list of commands to be executed by SUBMIT 


temporary file 


In some of the command summaries, descriptive qualifiers are 
used in the syntax line with filespecs to further qualify the type 
of filespec accepted by the commands. For example, wildcard- 
filespec denotes wildcard specifications, dest-filespec denotes a 
destination filespec, and src-filespec denotes a source filespec. 
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4.6 How Commands are Described 


In Section 5, the Command Summary, CP/M~68K commands appear in 
alphabetical order. Each command description is given in a specific 
form. Section 5 also describes the notation that indicates the 
optional parts of a command line and other. syntax notation. 


e@ The description begins with the command keyword in upper-case. 


@ The syntax section gives you one or more general forms to 
follow when you compose the command line. 


e The explanation section defines the general use of the command 
keyword, and points out exceptions and special cases. The 
explanation sometimes includes tables or lists of options that 
you can use in the command line. 


@ The examples section lists a number of valid command lines that 
use the command keyword. 


The notation in the syntax lines describes Ene: general command 
form using these rules: 


@ Words in capital letters must be spelled as shown, but you can 
use any combination of upper- or lower-case letters. 


e@ A lower-case word in the syntax line has a general meaning that 
* is defined in the text. 


@ The symbolic notation d:, filename, .typ, and filespec have the 
general meanings described in Section 4.5. 


e You mist include one or more space characters where a space is 
shown, unless otherwise specified. For example, the PIP 
options do not need to be separated by spaces. 


oe) 


The following table defines the special syntactical symbols 
used in defining command line syntax. Unless otherwise noted, none 
of these symbols actually appear on your screen's command line; they 
exist solely on these pages so that can see the general form for a 
given command line. Understanding this notation helps you form a 
valid command. 
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Table 4-5. Command Line Conventions 


You can substitute a number for n. 


You can substitute an option or a list of 
options. 


You can substitute a string, which consists 
of a group of characters, for s. 


Items within braces are optional. You can 
enter a command without the optional items. 
The optional items add effects to your 
command line. 


Items in square brackets are options or an 
option list. If you use an option specified 
within the brackets, the brackets must 
enclose the option. If the right bracket is 
the last character on the command line, it 
can be omitted. These brackets actually 
appear on your command line, having the same 
meaning on a command line as they do in our 
command summary examples. 


Items in parentheses indicate a range of 
options. If you use a range from an option 
list, you must enclose the range within 
parentheses. 


Ellipses tell you that the previous item can 
be repeated any number of times. ; 


The or bar separates alternative items in a 
command line. You can select any or all of 
the alternatives specified. Mutually 
exclusive options are indicated in additional 
syntax lines or are specifically noted in the 
text. 


Represent the CTRL key on your keyboard. As 
a rule, control characters that do not havea 
command-line editing function appear on the 
screen, with the sign, ~*~, preceding the 
letter. Control characters that have 
command-line editing functions (See Table 3- 
1) do not appear on the screen when they are 
executed. 


Indicates a RETURN keystroke. In most of the 
examples in this book, the RETURN keystroke 
is implied and therefore does not appear in 
the examples. : 
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Table 4-5. (continued) 


Wildcard character--replaces all or part of a 
filename or filetype. Appears on your screen 
and has the same meaning as it does in our 
command summary examples. ) 


Wildcard character--replaces any Single 
character in the same position of a filename 
or filetype. Appears on your screen and has 
the same meaning as it does in our command 
summary examples. 


Let's look at some examples of syntax notation. The CP/M-68K 
DIR (DIRectory) command displays the names of files catalogued in 
the disk directory. 


The syntax of the DIR commen shows how to use the command line 
syntax notation: 


Syntax: DIR (as) Ltetisees! 
optional optional 


This tells you that the command tail following the command 
keyword DIR is optional. In other words, DIR alone, or DIR with a . 
filespec, or DIR with just a drive specifier, or DIR with a drive & 4 
specifier and a filespec all are valid versions of the DIR command. ar 
For example, 


DIR | 

DIR john.ltr 
DIR b: 

DIR b:john.ltr : 
DIR b:john.* 
DIR b:*.1ltr 

DIR b:*.* 


are valid commands. The last example, Hes entaliys*< is equivalent 
to DIR b:; as shown by the general syntax: 
pIR {d:} | {f£ilespec} 


These are the only forms DIR can take with respect to john.itr, or 
any file, or no file. Understanding the syntax lets you see all the 
possibilities. 


t 
The CP/M-68K command PIP (Peripheral Interchange Program) é 
provides an example of a different kind of syntax. PIP can copy 
files from the disk to the screen or printer. PIP can combine two 
or more files into one longer file. PIP can also rename files after 
copying them. All of this functionality can be represented in the 
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PIP dest-filespec=src-filespec{,filespec...} 


In this example, dest-filespec is further defined as a 
destination file specification or peripheral device (printer, for 
example) that receives data. Similarly, src-filespec is a source 
file specification or peripheral device (keyboard, for example) that 
transmits data. PIP accepts wildcards in the filename and filetype. 
See the PIP command in Section 5 for details regarding other 
capabilities of PIP. There are, of course, many valid command lines 
that come from this syntax. Some of them are shown below. 


A>PIP NEWFILE.DAT=OLDFI MS . ma 

A>PIP B:=A: THISFILE.DAT 

A>PIP B:X.BAS=¥.BAS, 2.2Q5 

A>PIP X.BAS=A.BAS, B.BnS, C.aas 

A>PIP B:=A:* .BAK ; 
A>PIP B:=A:*.¢ | 


End of Section 4 
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Section 5 
Command Summary 


This section describes the commands and programs supplied with 
your CP/M~-68K operating system. The commands are in alphabetical 
Order. Each command is followed by a short explanation of its 
Operation and examples. ED, the CP/M-68K editor, is described in 
detail in Section 6. Other commands, such as AS68 and DDT-68™ 
are described fully in the CP/M-68K Programmer's Guide. 


5.1 The COPY (copy disk) Command 
Syntax: copy {option list} 


Explanation: COPY copies the contents of one disk on to another. 
It does so on a track-by-track basis, giving you a 
literal image of the disk or a selective part of the 
disk you want to copy. 


Unlike PIP, which needs to know both the type and 
length of file to be copied, COPY is not sensitive to 
the types of files or their lengths. Even so, COPY 
requires that your destination disk have the same 
format as your source disk. Hence you may have to 
format a destination disk before using COPY. If so, 
see FORMAT for details. 


As shown in the above syntax, you can type copy and 
then press the RETURN key. This is the simplest 
form of executing COPY. It is also the most 
interactive. When you load COPY this way, the 
following prompt comes to your screen: 


Copy Ver 1.1 


A mode menu then appears: 


MODE FUNCTION 

ALL Copy the whole disk 

BOOT Copy the boot tracks 
FILES Copy the non-boot tracks 
END End this program 


Choose one mode from the mode menu. For example, if 
you want to copy everything on one of your CP/M-68K 
disks, choose ALL to copy CP/M-68K and all files 
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beyond the boot tracks. Choose BOOT if you want to 
copy only the boot loader for CP/M-68K. Choose FILES 
if you want to copy only the non-boot tracks. Choose 
END if you wish to leave the COPY program and return 
to the command level of CP/M~-68K. 


Once you have selected your mode, COPY prompts you 
with 


Enter SOURCE drive: __ 


At the cursor position, type a drive letter in the 
range a...p and press the RETURN key. 


Similarly, you get the prompt: 
Enter DESTINATION drive: __ 


Reply with a drive letter in the range a...p and 
press the RETURN key. COPY prompts: 


(*C to ABORT) 
RETURN to copy <mode> from <source> to <destination>. 


Mode, source, and destination have actual values on 
your screen in place of the words shown here. If 
these are the values you truly want COPY to use, 
press the RETURN key. COPY begins copying at this 
point, as indicated by the message, ***Copying nn 
Tracks***, that appears at the bottom of your screen. 
The nn in this prompt stands for the actual track 
numbers currently being copied. 


If you decide to abort the copy process, type CTRL-C 
(that is, hold down the CONTROL key and press the 
letter C). If you have not used the [A] (for 
automatic) option when you were at the CP/M~68K 
command line, then you are offered a chance to do 
some more copying when COPY finishes your first. copy. 
COPY saves the parameters you gave it for the last 
copy just made; then COPY asks you: 


Do you wish to repeat the copy? __ 


Type y if you do, n if you do not. If you type n, 
the COPY program ends without any further processing 
and returns you to the CP/M-68K command level. If 
you type y, COPY shows you the values used in the 
last copy session and invites you to start another 
copy session by entering a carriage return. For 
example, if you chose mode ALL, source drive A, and 
destination drive B in your initial copy session, 
COPY returns the following prompt for all subsequent 
copy sessions: 


C- 
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Examples: 


(*C to ABORT) 
RETURN to copy ALL from A to B 


If you decide at this point not to begin a new 
session, type CTRL-C. CTRL-C returns you to the 
command level of CP/M-68K. 


Instead of typing COPY and pressing the RETURN key at 
the command level, you can supply your copy options 
before COPY is loaded and executed. However, if you 
take advantage of this shortcut, you must present 
your options in a certain order. The order for COPY 
options is 


mode option} before 

source drive option} before 

destination drive option} before 

automatic carriage return option} 
and/or {verify option} before 

{manual carriage return} 


Some representative combinations of the COPY command 
line appear below: 


COPY ALL 
COPY AEL 
COPY ALL 
COPY ALL 
COPY ALL 
COPY ALL 

A 

B 


COPY 

COPY 

COPY [A] 
COPY [Vv] 
COPY. [AV] 
COPY AB 
COPY AB [A] 
COPY AB [V] 
COPY AB [AV] 


COPY ALL A B 
COPY ALL A B [A] 
COPY- ALL AB [(V] 
COPY ALL AB [AV] 


With the exception of the A and V options, which are 
discussed below, each of the options in the above 
examples is explained in the preceding basic, 
interactive COPY session. 
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Note: Be sure the source drive appears to the left 
of the destination drive in your option list. If you 
inadvertently get the the drive letters of your 
destination drive and source drive turned around in 
this option list, you will copy your destination disk 
(probably blank) on to your source disk, thereby 
wiping it out. Avoid this by entering the source 
drive letter before you specify the destination drive 
letter. Then recheck what you typed before you press 
the RETURN key. 


fhe bracketed A acts as a virtual RETURN key at run- 
time when the operator normally would be required to 
set the copy process in motion once the parameters 
have been supplied to COPY. Specifying the [A] 
option allows the copy process to execute without 
interruption and without further operator 
interaction. 


The bracketed V invokes COPY's verification option. 
When you use the bracketed V, COPY compares the data 
on source and destination disks following a copying 
operation, to verify that the data on the two disks 
are the same. COPY with the V option runs more 
slowly than COPY without the V option. This is 
because the V demands that COPY go through extra 
steps in reading the destination disk and comparing 
its data to the data on the source disk.- 


If you enter more options in the option list than 
COPY uses, those extra options are thrown away. For 
example, if you type 


A>COPY FILES A B HELLO THERE 
the COPY utility loads then displays the message: 


Extraneous argument ignored: hello 
Extraneous argument ignored: there 
(*C to ABORT) 

RETURN to copy FILES from A to B__ 


Thus COPY helps salvage the copy session for you by 
allowing you to either abort COPY or else continue 
with the copy process, using the only three valid 
options it found from the command line in this 
example. 
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5.2 The DIR (Directory) and DIRS (System Directory) Commands 


Syntax: 


Explanation: 


DIR tees 
DIR {filespec} 


DIRS i 
DIRS {filespec} 


The DIR and DIRS built-in commands display the names 
of files contained in the directory of an on-line 
disk. 


The DIR command lists the names of files in the 
current user area that have the Directory (DIR) 
attribute. .-The DIRS command displays the names of 
files in the current user area that have the System 
(SYS) attribute. 


All executable files in user area 0, regardless of 
their SYS or DIR attribute, can be executed 
regardless of the current user number. However, you 
must be in user area 0 to display those files with 
DIR or DIRS. 


If the drive and file specifications are omitted, the 
DIR command displays the names of all files with the 
DIR attribute on. the disk in the default drive and 
current. user number. In the same way, DIRS displays 
the SYS files. 


Tf the drive specification is included, but the 
filename and filetype are omitted, the DIR command 
displays the names of all DIR files in the current 
user area on the disk in the specified drive. DIRS 
displays the SYS files. 


Both DIR and DIRS accept wildcard filenames and 
filetypes. When you use wildcard characters, all 
filenames that satisfy the match are displayed on the 
screen. 


If no filenames match the file specification, or if 
no files are catalogued in the directory of the disk 
in the named drive and user number, the DIR and DIRS 
commands each display the message: 


No File 


If system (SYS) files that reside on the specified 
drive and user number match the file specification, 
DIR displays the message: 


SYSTEM FILE(S) EXIST 
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If nonsystem (DIR) files match the file 
specification, DIRS displays the message: 


NON-SYSTEM FILES(S) EXIST 


A>DIR 


Displays all DIR files catalogued in user 0 on the 
default drive A. 


A>DIR B: 
Displays all DIR files for user 0 on drive B. 
A>DIR B:X.BAS 


Displays the name X.BAS if the file X.BAS is present 
on drive B. 


4A>DIR *.BAS 


Displays all DIR files with filetype BAS for user 4 
on drive A. 


B>DIR A:X*.C?D 

Displays all DIR files for user 0 on drive A whose 
filename begins with the letter X, and whose three 
character filetype contains the first character C and 
last character D. 

A>DIRS 


Displays all files for user 0 on drive A that have - 
the system (SYS) attribute. 


3A>DIRS *.68K . 
This wildcard form of the DIRS command displays all 


SYS files with filetype 68K on the default drive A 
for user 3. 
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5.3 The ED (Character File Editor) Command 


Syntax: 
anes eae E CRE 


Explanation: 


ED input-filespec {dz | output-filespec} 


The ED transient utility lets you create and edit a 
disk file. 


The ED utility is a line-oriented context editor. 
This means that you create and change character files 
line-by-line, or by referencing individual characters 
within a line. : 


The ED utility lets you create or alter the file 
named in the file specification. Refer to Section 6 
for a more detailed description of the ED utility. 


The ED utility uses a portion of your user memory as 
the active text buffer where you add, delete, or 
alter the characters in the file. You use the A 
command to read all or a portion of the file into the 
buffer. You use the W or E command to write all or a 
portion of the characters from the buffer back to the 
file. : 


An imaginary character pointer, called CP, is at the 
beginning of the buffer, between two characters in 
the buffer, or at the end of the buffer. 


You interact with the ED utility in either command or 
insert mode. ED displays the * prompt on the screen 
when ED is in command mode. When the * appears, you 
can enter the single letter command that reads text 
from the buffer, moves the CP, or changes the ED mode 
of operation. When in command mode, you can use the 
line-editing characters CTRL-E, -H, -U, -X, and 
RUBOUT to edit your input. In insert mode, however, 
you use only CTRL-H, -U, -X, and RUBOUT. 


Table 5-1. ED Command Summary 


Command Action. — 


Append n lines from original file to 
memory buffer. 


Append file until buffer is one half 
full or until end of input is 
reached. 
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fable 5-1. (continued) 


Command Action 


Append file until buffer is full (or 
end of file). 


Move CP to beginning (B) or bottom 
(-B) of buffer. 


Move CP n characters forward (C) or 
back (-C) through buffer. 


Delete n characters before (-D) or 
from (D) the CP. 


Save new file and return to CP/M- 
68K. 


eects) 


Find character string. 


Save the new file, then reedit, 
using the new file as the original 
file. 


Enter insert mode; use {Z to exit 
insert mode. 


Istring{tz} 


Insert string at CP. 
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Table Sl. (continued) 


Command Action 


Jsearch str“Zins_str“Zdel_to_str{fz} 


Juxtapose strings. 


Delete (kill) n lines from the CP. 


OL 


-nL, 


Move CP n lines. 


Execute commands n times. 


Move CP n lines and display that 
line. 


Move to line n. 


Execute command through line n. 


Nstring{{z} 


Extended find string. 


Return to original file. 


Move CP 23 lines forward and display 
_ 23 lines at console. 
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Table S~1. (continued) 


Command Action 


Abandon new file, return to CP/M- 
68K. we, 
Read XS$$SSSSS$.LIB file into buffer. 


Rfilespec{ fz} 


Read filespec into buffer. 


Sdelete string*Zinsert string{}z} 
Substitute string. 


Type n lines. 


Upper-case translation. 


Line numbering on/off, display free 
buffer space. 


Write n lines to new 


Write or append n lines to 
XSSSSSS$ LIB. 
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Table 5-1. (continued) 


Command Action — 


nXfilespec{tz} 


Write n lines to filespec or append 
if previous x command applied to the 
same file. 


Delete file XS$SSSS$SS$.LIB. 


0xfilespec{ fz} 


Delete filespec. 


Wait n seconds. 
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5.4 The ERA Command 


Syntax: 


Explanation: 


Examples: 


wer em ee: 


ae 


ERA {filespec} 


The ERA command removes one or more files from the 


‘directory of a disk. Wildcard characters are 


accepted in the filespec. Directory and data space 
are automatically reclaimed for later use by another 
file. 


Use the ERA command with care because all files that 
Satisfy the file specification are removed from the 
disk directory. 


Command lines that take the form: 
ERA {d:}wildcard-filespec 


require your confirmation because they erase an 
entire group of files, not just one file. The system 
prompts with the following message: 


Confirm (Y/N)? 


Respond with y if you want to remove all matching - 
files, and n if you want to avoid erasing any files. 


There is one instance in which the ERA command with a 
wildcard does not cause the system to prompt you. In 
a SUBMIT file, when you use a wildcard with an ERA 
command, CP/M-68K does not ask for confirmation. 
Please see Section 5.10 for a discussion of the 
SUBMIT command. 


If no files match the file specification, you see the 
following message: 


No File 


A>ERA X.PAS 


This command removes the file X.PAS from the disk in 
drive A. 


A>ERA *.PRN 
The system asks to confirm: 


Confirm (Y/N) ?¥ 
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All files with the filetype PRN are removed from the 


disk in drive A, user 0. 


A>ERA B:*.* 
Confirm (Y/N) ?Y 


All files on drive B, user 0, are removed from the 
disk. 
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5.5 The FORMAT Command 
Syntax: FORMAT {disk drive} 


Explanation: Digital Research provides a format utility, called 
FORMAT, that is compatible with CP/M-68K and the 
Motorola EXORmacs computer. The EXORmacs hardware is 
described in the CP/M-68K erating System System 
Guide. 


Most CP/M-68K users do not have an EXORmacs. 
Consequently, their disk formatting programs are 
supplied by the vendors of their non-EXORmacs 
hardware. Just. the same, the formatting concepts 
mentioned above apply to all disk users, whatever 
brand of hardware is used. 


Formatting establishes the desired disk density 
(either single density or double density), the 
desired sector size (128, 256, 512, or 1024), and the 
number of tracks appropriate for the disk to be 
formatted. Formatting makes a disk ready to receive 
new data from another disk having the identical 
format, Thus formatting is a preliminary, and often 
necessary, step to copying. 


Although you can often set the density and sector 
size by using a formatting utility, you have no 
control over the number of tracks that are selected 
by the utility. That parameter is determined by the 
particular disk controller logic inside your disk 
cabinet; it is hardware dependent. Consequently, 
computer hardware manufacturers often write the 
formatting utilities to go with the hardware they 
sell. 


Whether you format a floppy disk or a hard disk, all 
files on the disk may be erased as part of the 
formatting procedure. The utility's behavior depends 
on the version supplied you by the manufacturer of 
your equipment. 


Executing FORMAT at the CP/M-68K command level takes 
the form: 


A>FORMAT a 


where d specifies a disk in the range a...p. 
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As with INIT, FORMAT asks you to reconfirm your 
choice in the following prompt: 


Do you really want to format disk d? 


a Press y for yes, in either upper-case or lower-case, 
if you wish to continue. Reply with n for no, if you 
decide not to format disk d. If you reply to the 
above question with any character other than y, 
FORMAT aborts execution and returns you to the 
command level of CP/M-68K. 
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5.6 The INIT Command 


Syntax: INrIt {disk drive} 
Explanation: INIT initializes disk directories. That is, INIT Z 
————~- purges the contents of an existing directory by ) 


marking each sector in the directory area as unused, 
ready to be written on. Once this happens, data 
files referenced by the initialized directory are 
virtually erased. The effect is very similar to ERA 
*.,*, but more thorough than ERAse because INIT can 
access every directory entry, no matter how bizarre 
the directory entry may be. Therefore, the primary 
use of INIT is to clean up a corrupted directory. If 
this is your purpose, be sure to PIP any important 
files from the disk to be initialized on to a back-up 
disk, then use INIT. 


Note that INIT cannot change the size of your sectors 
or the density of your disk. In other words, INIT 
cannot reformat anything. INIT is hardware 
independent; it can be used on any computer equipped 
with. Motorola's 68000 CPU and Digital Research's 
CP/M-68K operating Sy Stam: 


Executing INIT from the CP/M~68K command level takes 
the form: 


we, 


A>INIT @ 
where d specifies a drive in the range a...p. 


If initialization erases the contents of all 
directory entries on disk, CP/M-68K seeks 
reconfirmation of your intent before it proceeds: 


. Do you really want to initialize disk d? 


Reply y for yes, or n for no, to the question. INIT 
proceeds to initialize your disk if you reply y. 
Reply with n for no if you decide not to initialize 
disk d. If you reply to the above question with any 
character other than y, INIT aborts execution and 
returns you to the command level of CP/M-68K. 
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5.7 PIP (Peripheral Interchange Program - Copy File) Command 


Syntax: 


Explanation: 


5.7.1 Single 


Syntax: 


Explanation: 


PIP dest-file{ (Gn] } |dev=src-file{ (o]}|dev{[o] } 


The PIP utility copies one or more files from one disk 
and or user number to another. PIP can rename a file 
after copying it. PIP can combine two or more files 
into one file. PIP can also copy a character file 
from disk to the printer or other auxiliary logical 
output device. PIP can create a file on disk from 
input from the console or other logical input device. 
PIP can transfer data from a logical input device to 
a logical output device. Hence the name Peripheral 
Interchange Program. 


File Copy 


PIP d:{[Gn]} = source~filespec{ [options] } 
PIP dest-filespec{[Gn]} = d:{ [options] } 


PIP dest-filespec{(Gn]} = source-filespec{ [0] } 


The first form shows the simplest way to copy a file. 
PIP looks for the file named by source~-filespec on 
the default or optionally specified drive. PIP 
copies the file to the drive specified by d: and 
gives it the same name as source-filespec. If you 
want, you can use the [Gn] option to place your 
destination file (dest-filespec) in the user number 
specified by n. The only option recognized for the 
destination file is [Gn]. Several options can be 
combined together for the source file specification 
(source~filespec). See the section on PIP options. 


The second form is a variation of the first. PIP 

looks for the file named by dest-filespec on the_ 
drive specified by d:, copies it to the default or 

optionally specified drive, and gives it the same 

name as dest-filespec. 


The third form shows how to rename the file after you 
copy it. You can copy it to the same drive and user 
number, or: to a different drive and/or user number. 
Rules for options are the same. PIP looks for the 
file specified by source-filespec, copies it the the 
location specified in dest-filespec, and gives it the 
name indicated by dest~filespec. 
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Remember that PIP always goes to and gets from the 
current user number unless you specify otherwise with 
the (Gn) option. 


Before you start PIP, be sure that you have enough 
free space in kilobytes on your destination disk to 
hold the entire file or files that you are copying. 
Even if you are replacing an old copy on the 
destination disk with a new copy, PIP still needs 
enough room for the new copy before it deletes the 
old copy. See the STAT command in this section. 


Data is first copied to a temporary file to ensure 
that the entire data file can be constructed within 
the space available on the disk. PIP gives the 
temporary file the filename specified for the 
destination, with the filetype $$$. If the copy 
operation is successful, PIP changes the temporary 
filetype $$$ to the filetype specified in the 
destination. 


If the copy operation succeeds and a file with the 
Same name as the destination file already exists, the 
old file with the same name is erased before renaming 
the temporary file. 


File attributes (SYS, DIR, RW, RO) are transferred 
with the files. 


If the existing destination file is set to Read-Only 
(RO), PIP asks. you if you want to delete it. Answer 
Y or N. Use the W option to write over Read-Only 
files. 


You can include PIP options following each source 
name (see PIP Options, below). There is one valid 
option, [Gn] =~ go to user number n, for the 
destination file specification. Options are enclosed 
in square brackets. Several options can be included 
for the source files. They can be packed together or 


separated by spaces. Options can verify that a file | 


was copied correctly, allow PIP to read a file with 
the system (SYS) attribute, cause PIP to write over 
Read-Only files, cause PIP to put a file into or copy 
it from a specified user number, transfer from lower- 
to upper-case, and much more. 


A>PIP B:=A:oldfile.dat 


A>PIP B:oldfile.dat = A: 


Both forms of this command cause PIP to read the file 
oldfile.dat from drive A and put an exact copy of it 
onto drive B. This is called the short form of PIP, 
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because the source or destination names only a drive 
and does not include a filename. When using this 
form you cannot copy a file from one drive and user 
number to the same drive and user number. You must 
put the destination file on a different drive or ina 
different user number. See the section on PIP 
Options, and the section on the USER command. The 
second short form produces exactly the same result as 
the first one. PIP simply looks for the file 
Oldfile.dat on drive A, the drive specified as the 
source. 


A>PIP Bsnewfile.dat=A:oldfile.dat 


This command copies the file oldfile.dat from drive A 
to drive B and renames it to newfile.dat. The file 
remains as oldfile.dat on drive A. This is the long 
form of the PIP command, because it names a file on 
both sides of the command line. 


A>PIP newfile.dat = oldfile.dat 


Using this long form of PIP, you can copy a file from 
one drive and user number (usually user 0 because 
CP/M-68K automatically starts out in user 0 — the 
default user number) to the same drive and user 
number. This effectively gives you two copies of the 
Same file on one arive and user number, each with a 
different name. 


A>PIP B:PROGRAM.BAK = A: PROGRAM. DAT([(G1] 


The command above copies the file PROGRAM.DAT from 
user 1 on drive A to user 0 on drive B and renames 
the filetype on drive B, user 0, to BAK. 


B>PIP program2.dat = A:programl.dat(E V G3] 


In this command, PIP copies the file named 
programl.dat on drive A and echoes [E] the transfer 
to the console, verifies [V] that the two copies are 
exactly the same, and gets (G3] the file programl.dat 
from user 3 on drive A. Since there is no drive 
Specified for the deStination, PIP automatically 
copies the file to the default user number and drive, 
in this case drive B, user 0. 


5.7.2 Multiple File Copy 


Syntax: 


PIP d:{(Gn]} = {d:}wildcard-filespec{ [0] } 
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Explanation: Wheri you use a wildcard in the source specification, 
———————-__ PIP copies qualifying files one-by~one to the 
destination drive, retaining the original name of 
each file. PIP displays the message, COPYING, 
followed by -each filename as the copy operation 
proceeds. PIP issues an error message and aborts the 
copy operation if the destination drive and user ; 
number are the same as those specified in the source. a) 


Examples: A>PIP B:2A:*.CMD 


This command causes PIP to copy all the files on 
drive A with the filetype CMD to drive B. 


A>PIP B:=A:*.* 


This command causes PIP to copy all the files on 
drive Ato drive B. You can use this command to make 
a back-up copy of your distribution disk. Note, 
however, that this command does not copy the CP/M-68K 
bootstrap loader from the system tracks. COPY, or 
any other track-to-track copy program, copies the 
system tracks for you. 


A>PIP B:=A:PROG?22?.* 


The command above causes PIP to copy all files 
beginning with PROG and having any filetype at all | 
from drive A to drive B. a, 


A>PIP B: [G1] =A: * .A86 


This command causes PIP to copy all the files with a 
filetype of A86 on drive A in the default user 
number, user ZERO in this case, -to drive B in user 
number 1. Remember that the DIR, TYPE, ERA and other 
commands only access files in the same user number 
from which they were invoked. See the USER command. 


5.7.3 Combining Files 


Syntax: PIP geet iter iGaui vere, titer tort) lyeite 
{ [opt] }{,file{[opt}}... 


Explanation: This form of the PIP command lets you specify two or 
———— More files in the source. PIP copies the files 
specified in the source from left to right and ie 
combines them into one file with the name indicated 
by the destination file specification. This 
procedure is called file concatenation. You can use 
the [Gn] option after the deStination file to place 
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it in the user number specified by nn. You can 
specify one or more options for each source file. 


Most of the options force PIP to copy files character 
by character. In these cases PIP looks for a CTRL-Z 
character to determine where the end of the file is. 
All of the PIP options force a character transfer 
except the following: 


Gn,K,0O,R,V, and W. 


Copying data to or from logical devices also forces a 
character transfer. 


During character transfers, you can terminate a file 
concatenation operation by pressing CTRL-C. 


When concatenating files, PIP only searches the last 
record of a file for the CTRL-Z end-of-file 
character. However, if PIP is doing a character 
transfer, it stoos when it encounters a CTRL-Z 
character. 


Use the [0] option if you are concatenating machine 
code files. The [0] option causes PIP to ignore 
embedded CTRL-Z (end-of-file) characters, normally 
used to indicate the end-of-file character in files. 


Examples: A>PIP NEWFILE=FILE1,FILE2,FILE3 


The three files named FILE1, FILE2, and FILE3 are 
joined from left to right and copied to NEWFILE.SSS$. 
NEWFILE.$S$ is renamed to NEWFILE upon successful 
completion of the copy operation. All source and 
destination files are on the disk in the default 
drive A. 


A>PIP B:X.A86 = Y.A86, B:Z.A86 
The file Y.A86 on drive A is joined with 2.A86 from 
drive B and placed in the temporary file X.$S$$ on 


drive B. The file X.$$$ is renamed to X.A86 on drive 
B when PIP runs to successful completion. 


5.7.4 Copy Files to and from Auxiliary Devices 


Syntax: PIP dest-filespec {{Gn]} = source-filespec {[o}} 
cae AXO: AXI: ea | 

CON: CON: { [options} 

PRN: NUL: 

LST: EOP: 
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Explanation: 


Examples: 


This form is a special case of the PIP command line 

that lets you copy a file from a disk to a device, 

from a device to a disk, or from one device to 
another. The files must contain printable 
characters. Each peripheral device is assigned to a 
logical name that identifies a source device that can 
transmit, data or a destination device that can ‘ 
receive data. A colon (:) follows each logical Na, 
device name so it cannot be confused with a filename. 

Press CTRL-C to abort a copy operation that uses a 
logical device in the source or destination. 


The logical device names are listed as follows: 


CON: 


Console: the physical device assigned to 
CON. When used as a source, usually the 
keyboard; when used as a Gestsnactote 
usually the screen. 


Auxiliary Input or Output Device. 
Auxiliary Output Device. 


The destination device assigned to LST, 
usually the printer. 


There are three device names that have special 


meaning: LD) 


A virtual source device that produces 40 
hexadecimal zeroes. 


A virtual source device that produces a 
Single CTRL-Z, the CP/M-68K end-of-file 
mark. 


The printer device with tab expansion to 
every eighth column, line numbers, and 
page ejects every 60th line. 


B>PIP PRN: =CON: ,MYDATA.DAT 


Characters are first read from the console input 
device, generally the keyboard, and sent directly to 

your printer device. You type a CTRL-Z character to 

tell PIP that keyboard input is complete. At that 
time, PIP continues by reading character data from ae 
the file MYDATA.DAT on drive B. Because PRN: is the 
destination device, tabs are expanded, line numbers 

are added, and page ejects occur every 60 lines. 
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A>PIP B: FUNFILE.SUE=CON: 


If CRT: is assigned to CON:, whatever you type at the 
console is written to the file FUNFILE.SUE on drive 
B. You must press the RETURN key and the linefeed 
key to commit your input to the file. End the 
keyboard input by typing a CTRL-Z. Corrections of 
previously typed material are not permitted in this 
option. 


A>PIP LST: =CON: 


If CRT: is assigned to CON:, whatever you type at the 
keyboard is written to the list device, generally the 
printer. Terminate input with a CTRL-Z. 


A>PIP LST:=B:DRAFT.TXT (T8] 


The file DRAFT.TXT on drive B is written to the 
printer device. Any tab characters are expanded to 
the nearest column that is a multiple of 8. 


A>PIP PRN:=B:DRAFT.TXT 


The command above causes PIP to write the file 
DRAFT.TXT to the list device. It automatically 
expands the tabs, adds line numbers, ai ejects pages 
after sixty lines. 


5.7.5 Multiple Command Mode 
Syntax; PIP 


Explanation: This form of the PIP command starts the PIP utility 
a and lets you type multiple command lines while PIP 
remains in user memory. 


_ PIP writes an asterisk (*) on your screen when ready 
to accept input command lines. 


You can type any valid command line described under 
previous PIP formats following the asterisk prompt. 


Terminate PIP by pushing only the RETURN key 
following the asterisk prompt. The empty command 


line tells PIP to discontinue operation and return to 
the CP/M-68K system prompt. 
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Examples: A>PIP 
ja oe *BEMFILE=FILE],FILEZ,FILE3 

*APROG. CHD=BPROG.CMD 

*A: =B:X.A86 

*B: at es = 

* ® 


This command loads the PIP program. The PIP command 
input prompt (*) tells you that PIP is ready to 
accept commands. The effects of this sequence of 
commands are the same as shown in the previous 
examples, where the command tail is included in the 
command line. PIP is not loaded into memory for each 
command. 


5.7.6 Using Options with PIP 


Explanation: Options enable you to process your source file in 

————__ special ways. You can expand tab characters, 
translate from upper- to lower-case, extract portions 
of your text, verify that the copy is correct, and 
much more. 


The PIP options are listed below, using n to 
represent a number and s to represent a sequence of 
characters terminated by a CTRL-Z. An option must : 
immediately follow the file or device it affects. — 
The option must be enclosed in square brackets []. 

For those options that require a numeric value, no 
blanks can occur between the letter and the value. 


You can include the [Gn] option after a destination 
file specification. You can include a list of 
options after a source file or source device. An 
option list is a sequence of single letters and 
numeric values that are optionally separated by 
blanks and enclosed in square brackets []}. ~ . 
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Table 5-2. PIP Options 


; Delete any characters past column n. 
Ni: : This parameter follows a source file 
that contains lines too long to be 
handled by the destination device, 
for example, an 80-character printer 
Or narrow console. The number n 
should be the maximum column width 
of the destination device. 


Echo transfer at console. When this 
parameter follows a source name, PIP 
displays the source data at the 
console as the copy is taking place. 
The source, must contain character 
data. 


Filter form-feeds. When this 
parameter follows a source name, PIP 
removes all form-feeds embedded in 
the source data. To change form- 
feeds set for one page length in the 
source file to another page length 


in the destination file, use-the F 
command to delete the old form-feeds 
and a P command to simultaneously 
add new form-feeds to the 
destination file. 


Get source from or Go to user number 
n. When this parameter follows a 
source name, PIP searches the 
directory of user number n for the 
source file. When it follows the 
destination name, PIP places the 
destination file in the user number 
specified by n. The number must be 
in the range 0 to 15. 


Hex data transfer. PIP checks all 
data for proper Intel® hexadecimal 
file format. The console displays 
error messages when errors occur. 
This function is included for 
historical reasons only. This PIP 
option does not affect Motorola S- 
records. ; 
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Table 5-2. (continued) 


Ignore :00 records in the transfer of 

Intel hexadecimal format file. The I . 
option automatically sets the H 7, 
option. This function is included 

for historical reasons only. This 

PIP option does not affect Motorola 
S-records. 


Translate upper-case alphabetics in 
the source file to lower-case in the 
destination file. This parameter 
follows the source device or 
filename. 


Add line numbers to the destination 

= file. When this parameter follows 
the source filename, PIP adds a line 
number to each line copied, starting 
with l and incrementing by one. A 
colon follows the line number. If 
N2 is specified, PIP adds leading 
zeroes to the line number and 
inserts a tab after the number. If 
the T parameter is also set, PIP 
expands the tab. 


Object file transfer for machine code 
(noncharacter and therefore 
nonprintable) files. PIP ignores 
any CTRL-Z end-of-file during 
concatenation and transfer. Use 
this option if you are combining 
object code files. 
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Table S5—2. (continued) 


Set page length. n specifies the 
number of lines per page. When this 
parameter modifies a source file, 
PIP includes a page eject at the’ 
beginning of the destination file 
and at every n lines. If n = 1 or 
is not specified, PIP inserts page 
ejects every 60 lines. When you- 
also specify the F option, PIP 
ignores form-feeds in the source 
data and inserts new form-feeds in 
the destination data at the page 
length specified by n. 


Quit copying from the source device 
after the string s. When used with 
the S parameter, this parameter can 
extract a portion of a source file. 
The string argument must be 
terminated by CTRL-Z. 


Read system (SYS) files. Normally, 
PIP ignores files marked with the 
system attribute in the disk 
directory. But when this parameter 
follows a source filename, PIP 
copies system files, including their 
attributes, to the destination. 


Ss Start copying from the source device 
at the string s. The string 
argument must be terminated by CTRL- 
Z. When used with the Q parameter, 
this parameter can extract a portion 
of a source file. Both start and 
quit strings are included in the 
destination file. 


Tn Expand tabs. When this parameter 
follows a source filename, PIP 
expands tab, CTRL-I, characters in 

the destination file. PIP replaces 

each CTRL-I with enough spaces to 

position the next character in a 

column divisible by n. 


Translate lower-case alphabetic 
characters in the source file to 
upper-case in the destination file. 
This parameter follows the source 
device or filename. 
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Table 5-2. (continued) 


Verify that data has been copied 
correctly. PIP compares the ; 
destination to the source data to <3 
ensure that the data has been 

written correctly. The destination 
must be a disk file. 


Write over files with RO (Read-Only) 
attribute. Normally, if a PIP 
command tail includes an existing RO 
file as a destination, PIP sends a 
query to the console to make sure 
you want to write over the existing 
file. When this parameter follows a 
source name, PIP overwrites the RO 
file without a console exchange. If 
the command tail contains multiple 
source files, this parameter need 
follow only the last file in the 
list. 


zero the parity bit. When this 
parameter follows a source name, PIP 
sets the parity bit of each data 
byte in the destination file to. 
zero. The source must contain 
character data. 


Examples: A>PIP NEWPROG .A86=CODE .A86 [L], DATA.A86 [U} 


This command constructs the file NEWPROG.A86 on drive 
A by joining the two files CODE.A86 and DATA.A86 from 
drive A. During the copy operation, CODE.A86 is 
translated to lower-case, while DATA.A86 is 
translated to upper-case. 


A>PIP CON: *WIDEFILE.A&6 [D80} 


This command writes the character file WIDEPILE.A86 
from drive A to the console device, but deletes all 
characters following the 80th column position. 


A>PIP B:=LETTER.TX£T[E] 


The file LETTER.TXT from drive A is copied to 
LETTER.TXT on drive B. The LETTER.TXT file is also 
written to the screen as the copy operation proceeds. 


A>PIP LST:=B:LONGPAGE.TXT [FP65] 
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This command writes the file LONGPAGE.TXT from drive 
B to the printer device. As the file is written, 
form-feed characters are removed and reinserted at 
the beginning and every 65th line thereafter. 


B>PIP LST: =PROGRAM.A86 [NT8U] 


This command writes the file PROGRAM.A86 from drive B 
to the printer device. The N parameter tells PIP to 
number each line. The T8 parameter expands tabs to 
every eighth column. The U parameter translates 
lower-case letters to upper-case as the file is 
printed. 


A>PIP 
* PORTION . TET“LETTER.TAT(SDear Sir“Z QSincerely”2] 


This command extracts a portion of the LETTER.TXT 
file from drive A by searching for the character 
sequence “Dear Sir" before starting the copy 
operation. When found, the characters are copied to 
PORTION.TXT on drive A until the sequence “Sincerely” 
is found in the source file. Note that this PIP 
option can only be used when PIP is in the multiple 
copy mode, even if you do not intend to make multiple 
copies. This option cannot be used in single copy 
mode on the same line as the PIP command keyword. 


B>PIP B:=A:*.CMD(VWR] 


This command copies all files with filetype CMD from 
drive A to drive B. The V parameter tells PIP to 
read the destination files to ensure that data was 
correctly transferred. The W parameter lets PIP 
overwrite any destination files that are marked as RO 
(Read-Only). The R parameter tells PIP to read files 
from drive A that are marked with the SYS (System) 
attribute. 
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5.8 The REN Command 


Syntax: 


Explanation: 


REN {new-filespec=old-filespec} 


The REN command lets you change the name of a file 
that is catalogued in the directory of a disk. 


The new-filespec must not be the name of any existing 
file on the disk. The old-filespec identifies an 
existing file on the disk. 


The REN command changes the name of the file named by 
old-filespec to the name given as new-filespec. If 
you put a space between the old-filespec and the 
equal sign or between the new-filespec and the equal 
sign, you must insert at least one space on the 
opposite side of the equal sign. 


CP/M-68K offers you a second method of using the REN 
command. Type REN then press RETURN. REN presents 
the following display: 

Enter Old Name: 


The cursor appears following Enter Old Name:. Enter 
the filespec you wish to rename and press RETURN. 
The following line appears on your screen: 


Enter New Name: 

The cursor then appears following Enter New Name:. 
Type in the new-filespec and, again, press RETURN to 
execute the REN command. - 


REN does not make a copy of the file. REN changes 


only the name of the file. 


If you omit the drive specifier, REN assumes the file 
to rename is on the default drive. You can include a 

drive specifier as a part of the newname. If both 
aoe specifications name a drive, it must be the same 
rive. 


If the file given by oldname does not exist, REN 
displays the following message on the screen: 


No File 

If the file given by newname is already present in 
the directory, REN displays the following message on 
the screen: 


File Already Exists 
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Examples: 


REN does not allow for wildcard filenames or 
filetypes. If you try to use a wildcard, REN tells 
yous 


No wildcard filenames 


A>REN NEWASM.BAS=OLDFILE.BAS 


The file OLDFILE.BAS changes to NEWASM.BAS on drive 
A. 


A>REN 

The system prompts for the filespecs: 

Enter Old Name:X.PRN 

Enter New Name:Y.PRN 

A> 

File X.PRN is renamed Y.PRN on drive A. 

B>REN A:X.PAS = Y.PLI 

The file Y.PLI changes to X.PAS on drive A. 

A>REN B:NEWLIST=B:OLDLIST _ | 
The file OLDLIST changes to NEWLIST on drive B. 
Since the second drive specifier, B: is implied by 
the first one, it is unnecessary in this example. 
The command line above has the same effect as the 
following: 
A>REN B:NEWLIST=OLDLIST 

or 


A>REN NEWLIST=B:OLDLIST 
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5.9 fhe STAT (Status) Command 


Syntax: STAT 

im STAT filespec {RO|RW|SYS|DIR|SIZE} 
STAT {ad:}DSK: | USR: 
STAT VAL: | DEV: 


Explanation: The various forms of the STAT utility command give you 

en information about the disk drives, files, and devices 
associated with your computer. STAT lets you change 
the attributes of files. You can also assign 
physical devices to the STAT logical device names. 


Note that the options following filespec can be 
enclosed in square brackets [], or be preceeded by a 
dollar $ sign or by no delimiter as shown in the 
syntax section above. 


The notation RW tells you a file is in a Read-Write 
state so that data can be both read from and written 

: to the file. A file marked RO, Read-Only, can be 
read from but not written to. 


Unlike other CP/M products, you cannot use STAT in 
CP/M-68K to set a drive to a Read-Only state. Drives 
are in a Read-Write state by default and become Read- 
Only only when you remove a disk on which a file is 
open. The drive reverts to a Read-Write state 
whenever you exit a program or type a CTRL-C, either 
of which causes a warm boot. Please see Section 4.4 
for a discussion of terminating programs and the term 
warm boot. 


Except for STAT VAL: and STAT DEV:, the STAT commands 
allow you to use a drive specifier. In CP/M-68K you 
can specify a drive that is different from the 
currently logged-in drive. The drive letter that 
appears in your system prompt identifies the logged- 
in drive. Execution of a STAT command with a drive 
specifier that differs from the logged-in drive does 
not change the logged-in drive. 


: In a STAT command, when you specify a drive that is 
. different from the logged-in drive, you place that 
drive in an active status. Active status is any drive 
accessed since the last warm or cold start. If you 
execute a STAT or STAT DSK: command without 
specifying a drive, STAT responds with information 

for any or all drives on active status. 
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5.9.1 Free Space on Disk 


Syntax: 


Explanation: 


Examples: 


5.9.2 Files 


Syntax: 


Explanation: 


stat {d:} 


STAT with no command tail reports the amount of free 
storage space that is available on all on-line disks. 
This form of the STAT command reports free space for 
only those disks that have been accessed since CP/M-=- 
68K was ladt started or reloaded. You can find the 
amount of free space :-on a particular disk by 
including the drive specifier in the command tail. 


This form of the STAT command displays information on 
your screen in the following form: 


d: RW, Free Space: nnk 

where d is the drive specifier, and n is the number 
of kilobytes of storage remaining on the disk in the 
drive specified by d. 


A>STAT 


Suppose you have two disk drives containing active 
disks. Suppose also that drive A has 16K (16,384) 
bytes of free space, while drive B has 32K (32,768) 
bytes of free space. The STAT command displays the 
following messages on your screen: 


A: RW, Pree Space: 16K 
B: RW, Free Space: 32K 


A>STAT B: 

Suppose drive B has 98 Kilobytes of storage that is 
free for program and data storage. The following 
message is displayed on your screen: 


Bs: RW, Free Space: 98K 
~ Display File Space and Access Mode 
STAT filespec {SIZE} 


This form of the STAT command displays the amount of 
Space in kilobytes used by the specified file. It 
also displays the Access Mode of the file. STAT 
accepts wildcards in the filename and filetype part 
of the command tail. When you include a wildcard in 
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your file specification, the STAT command displays a 
list of qualifying files from the default or 
specified drive, with their file characteristics, in 
alphabetical order. 


Note that the S option following the filespec can be 
enclosed in square brackets [], or be preceeded by a _) 
dollar $ sign, or by no delimiter as shown in the 

syntax line above. 


CP/M-68K supports four file Access Modes: 


RO The file has the Read-Only attribute that 
allows data to come from the file, but the file 
cannot be altered. 


RW. The file has the Read-Write attribute that 
allows data to move either to or from the file. 


SYS The file has the system attribute. System 
files do not appear in DIR (directory) 
displays. Use DIRS to show system (SYS) files. 
Use the STAT command to display all files . 
including those with the system attribute. The 
STAT command shows system files in parentheses.° 


DIR The file has the directory attribute .and 
appears in DIR (directory) displays. 


A file has either the RO or RW attribute, and either Ss 
the SYS or DIR attribute. By default, and unless 

changed by the STAT command , a file has the RW and 

DIR attributes. 


This format for the STAT command produces a list of 
file characteristics under five headings: 


e The first column displays the number of records 
used by the file, where each record is 128 bytes in 
length. This value is listed on your screen under 
the column marked Recs. 


e The second column displays the number of kilobytes 
used by the file, where each kilobyte contains 
1,024 bytes. This value is listed under Bytes. 


e The third column displays the number of directory 
entries used by the file. This value appears under 
the FCBs column. FCB (Pile Control Block) is a 
another name for a directory entry. as 
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Examples: 


@ The Access Modes are displayed under the Attributes 
column. 


e The file specification, consisting of the drive 
specifier, filename, and filetype of the file 
appears under Name on your screen. 


Use SIZE to tell STAT to compute the virtual file 
size of each file. The virtual and real file size 
are identical for sequential files, but can differ 
for files written in random mode. When you use SIZE, 
the additional column, marked Size, is displayed on 
the screen. The value in this column represents the 
number of filled and unfilled records allotted to the 
file. 


When you enter the command STAT *.*, STAT performs a 
directory verification to ensure that two files do 
not share the same disk space allocation. This means 
that the indicated file shares a portion of the disk 
with another file in the directory. If STAT finds a 
duplicate space allocation it displays the following 
message: 


Bad Directory on d: 

Space Allocation Conflict: 

User nn d:filename. typ’ 

STAT prints the user number and the name of the file 
containing doubly allocated space. More than one 
file can be listed. The recommended solution is to 
erase the listed files, and then type a CTRL-C. 


STAT does a complete directory verification whenever 
a wildcard character appears in the command tail. 


A>STAT MY* .* 


This command tells STAT to display the 
characteristics of all files that begin with the 
letters MY, with any filetype at all. Assume that 
the following three files satisfy the file 
specification. The screen could display the 
following: 


Drive B: User 0 
Recs By tes FCBs Attributes Name 
16 2K 1 Dir RW _B:MYPROG .A86 
8 1K 1 Dir RO sMYTEST .DAT 
32 18K 2 Sys RO B:MYTRAN .CMD 
Total: 21K 4 


B: RW, Free Space: 90K 
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A>STAT MY*.* SIZE 


This command causes the same action as the previous 
command, but includes the Size column in the display. 
Assume that MYFILE.DAT was written using random 
access from record number 8 through 15, leaving the 
first 8 records empty. The virtual file size is 16 
records, although the file only consumes eight 
records. The screen appears as follows: 


Drive B: User 0 
Size Recs Bytes FCBs Attributes Name 
16 16 2K 1 Dir RW B:MYPROG .A86 
16 8 1K 1 Dir RO B:MYTEST .DAT 
32 32 18K 2 Sys RO B:MYTRAN .CMD 
Total: - 21K 4 


B: RW, Free Space: 90K 


5.9.3 Set File Access Modes (Attributes) 


Syntax: STAT filespec RO |RW |SYS |DIR 

Explanation: This form of the STAT command lets you set the Access 

—————~—=—=—-——=——=—~ Mode for one or more files. Note that the option 
following filespec can be enclosed in square brackets 
[]), be preceeded by a dollar $ sign or by no 
delimiter as shown above. 

The four Access Modes, described above, are . 

RO 
RW 
sys 
DIR 
A file can have either the RO or RW Access Mode, but 
not both. Similarly, a file can have either the SYS 
or DIR Access Mode, but not both. 

Examples: A>STAT LETTER.TXT RO 
This command sets the Access Mode for the file 
LETTER .TXT on the default drive to RO. The following 
message appears on your screen if the file is 
present: = 
LETTER.TXT set to RO 
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The command: 
B>STAT A:*.68K SYS 


sets the Access Mode for all files on drive A, with 
filetype 68K, to SYS. Given that the three command 
files PIP, ED, and STAT are present on drive A, the 
following message appears on your screen: 


PIP.68K set to SYS 
ED.68K set to SYS 
STAT.68K set to SYS . 


5.9.4 Display Disk Status 


Syntax: 


Explanation: 


Examples: 


STAT {d:}DSK: 


This form of the STAT command displays internal 
information about your disk system for all on-line 
disks. The information provided by this command is 
useful for more advanced programming, and is not 
necessary for your everyday use of CP/M-68K. 


A>STAT DSK: 


This STAT command displays information about drive A 
in the following form. STAT supplies numbers for n. 


A: Drive Characteristics 
nnnn: 128 Byte Record Capacity 
nmnnn: Kilobyte Drive Capacity 
nnnn: 32 Byte Directory Entries 
nnnn: Checked Directory Entries 
nnnn: 128 Byte Records/Directory Entry 
nnnn: 128 Byte Records/Block 
nnnn: 128 Byte Records/Track 
nnnan: Reserved Tracks 


A>STAT B:DSK: 


This command produces the information shown in the 
previous example for drive B. 
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5.9.5 Display User Numbers with Active Files 


Syntax: 


Explanation: 


Examples: 


STAT {d:]}USR: 


This form of the STAT command lets you determine the 
user numbers that have files on the disk in the 
specified drive. 


User numbers are assigned to files that are created 
under CP/M-68K. Use this form of the STAT command to 
determine the active user numbers on a disk. 


A>STAT USR: 


This command displays the user numbers containing 
active files on the disk in drive A. 


5.9.6 Display STAT Commands and Device Names 


Syntax: 


Explanation: 


Examples: 


User Status 


STAT VAL: 


STAT VAL: displays the general form of the STAT 
commands. It also displays the possible physical 
device names that you can assign to each of the four 
CP/M-68K logical device names. 


The STAT VAL: display is shown below: 
A>STAT VAL: 


Set Attribute: d:filename.typ [ro] [rw] [sys] [dir] 
Disk Status : DSK: d:DSK: 
: USR: d:USR: 
Iobyte Assign: 
CON: = TTY: CRT: BAT: UC1: 
AXI: TTY: PTR: UR1: UR2: 


=z e 
AXO: = TTY: PTP: UPl: UP2: 
LST: = 7 
A> 


TTY: CRT: LPT: UL1: 
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5.9.7 Display and Set Physical to Logical Device Assignments 


Syntax: STAT DEV: 
STAT logical device: = physical device: 


Explanation: STAT DEV: displays the current assignments for the 
four CP/M-68K logical device names: CON:, RDR:, 
PUN:, and LST:. Use the second form of the above 
STAT command to change these current assignments. 
The command STAT VAL: displays the possible physical 
device names that you can assign to each logical 
device name. Refer to the part of the STAT VAL: 
display entitled, Iobyte Assign, shown above. 


When you assign a physical device to a logical 
device, STAT assigns a value from 0 to 3 to the 
logical device name in what is called the IObyte. 


You can assign’ any of the listed physical device 
names to their appropriate logical device names. 
However, the assignment does not work unless you are 
using the proper Input/Output Port (I/0) on your 
computer, with the proper cable to connect the 
computer to the device, and the proper I/O driver — 
routine for the particular physical device. This 
facility must. be supported by the manufacturer of 
your computer before the physical-to-logical 
assignments can be meaningful. 


Examples: A>STAT CON: = CRT: 


The command above assigns the physical device name 
CRT: to the logical input device name CON:, which 
generally refers to the console. 


A>STAT LST: = LPT: 
The command above assigns the physical device name 


LPT: to the logical output device name LST:, which 
generally refers to the list device of the printer. 
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5.10 ‘The SUBMIT (Batch Processing) Command 


Syntax: 


Explanation: 


Example: 


{supmMrt} {filespec (argumentl ... argument9)} 


The SUBMIT command lets you execute a group or batch 
of commands from a SUB file, which is a file with a 
filetype of SUB. 


Normally, you enter commands one line at atime. If 
you must enter the same sequence of commands several 
times, you might find it easier to batch the commands 
together using the SUBMIT command. To do this, you 
create a file and enter your commands in this file. 
The file is identified by the filename, and must have 
a filetype of SUB. When you issue the SUBMIT 
command, SUBMIT reads the file named by the filespec 
and prepares it for interpretation by CP/M-68K. When 
the preparation is complete, SUBMIT sends the file to 
CP/M-68K line by line, as if you were typing each 
comma nd. 


~ 


The following sample lines illustrate some of the 
variety of commands that can be entered in a SUB 


file: : 


DIR 

DIR *.BAK 

ERA * .BAK 

PIP LST: *$1.PRN(T$2 $3 $4) 
DIRS *.68K 

PIP A:*.LTR 

DIR B: 


5.10.1 Creating the SUB File 


Explanation: 


The SUB file can contain any valid CP/M-68K command or 
any valid CP/M-68K command with SUBMIT parameters. 
You can even reference other SUB files in a SUB file. 
Imbedded files of this kind are treated as chained 
files, not nested files. That is, any commands 
following an imbedded SUB file will be ignored; a SUB 
file called by another SUB file never returns to the 
caller after successful execution. For that reason, 
the last line in a SUB file is the only useful place 
for an imbedded SUB file. , 


If the imbedded SUB file cannot be executed, CP/M-68K 
branches around the nonexecutable SUB file and tries 
to execute those commands appearing below the 
imbedded SUB file. 
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You can put more than one command on a line if you 
separate each command with an exclamation mark. For 
example, 


ERA *.BAK ! DIR *.68K ! PIP $1:=$2:$3(V] 


contains three distinct CP/M-68K commands on one line 
of a SUBMIT file. The length of the line must not 
exceed 128 characters. 


You can create the SUB file with the ED utility, with 
some other editor, or with a word processing progran. 


You can pass arguments to SUB files when you execute 
them. Each argument you enter is assigned to a 
Parameter in the SUB file. The first argument 
replaces every occurrence of $1 in the file, the 
second argument replaces parameter $2,.etc., up to 
Parameter $9. For example, if your file START.SUB 
contains the following commands: 


ERA $1.BAK 

DIR $1 

PIP A: $12A:$2.68K 

PIP A: FINISH .SUB=A:$0.SUB 


and you enter the following SUBMIT command: ~ 
A>SUBMIT START SAM TEX | . 


SUBMIT substitutes these actual parameters for the 
symbolic stand-in parameters in your START.SUB file 
as sequential execution occur. In this example, the 
argument SAM is substituted for every $1 in the 
START.SUB file as sequential execution occurs, TEX is 
“ gubstituted for every occurrence of $2 in the 
START.SUB file, and START is substituted for $0. As 
each line is encountered in your SUB file, SUBMIT 
then executes this file, line by line. The 
substitutions look like this to SUBMIT: 


ERA SAM.BAK 

DIR SAM 

PIP A: SAM=A: TEX. 68K 

PIP A: FINISH.SUB=START.SUB 


If you enter fewer arguments in the SUBMIT command 
than there are parameters in the SUB file, the extra 
parameters are not used. 


If you enter more arguments in the SUBMIT command 
than there are parameters in the SUB file, the extra 
arguments are ignored. . 


To include an actual dollar sign $ in your SUB file, 
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type two dollar signs in a row, $$. SUBMIT replaces 

them with a single dollar sign. For example, if you 

have a file SEARCH.SUB and it contains the line 

DIR $1:*.S$$$S$ 

and you enter the following SUBMIT command, DD 
A>SUBMI?T SEARCH B 

then the translated file contains the following: 

DIR B:*.S$$$ 

The net effect in this example is that CP/M-68K looks 


for all files on drive B that have the filetype of 
$$$. 


5.10.2 Executing the SUBMIT Command 


To appreciate how SUBMIT is executed, recall the 
syntax mentioned earlier: 


Syntax: {SUBMIT} {filespec (argumentl ... argument9) } 
Explanation: Based on the above syntax, there are five ways of J 
_——————-_—s executing a SUBMIT command before the parameter list - 


is evaluated: - 


SUBMIT filename.SUB 
SUBMIT filename 
filename.SUB 
filename 

SUB MIT 


If the first form is used, CP/M-68K first looks in 
your current user area for the filename you typed 
with the filetype of SUB. If that file specification 
is found there, SUBMIT tries to execute the file. If 
it is not found in your current user area, CP/M-68K 
then searches user area 0 for filename.SUB. If it is 
not found in either user area, CP/M-68K displays on 
your console your filename with a question mark after 
it. 


If the second form is used, CP/M-68K appends the SUB 
filetype to your filename and searches for that file ar 
specification in your current user area, then in user ve. 
0, if need be. If that file specification is found, 

SUBMIT tries to execute the file. If it is not 

found, CP/M-68K displays on your console your 
filename with a question mark after it. 
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If the third form is used, CP/M-68K assumes you wish 
to invoke the SUBMIT command because you supplied the 
SUB filetype. If that file specification is found in 
your current user area (or user 0, if need be), 
SUBMIT tries to execute the file. If it is not 
found, CP/M-68K displays on your console your 
filename with a question mark after it. 


If the fourth form is used, the general rules of file 
searching as set forth in Section 4.2 take precedence 
as shown in the following three steps: 


1) CP/M-68K assumes you are trying to invoke a 
program file in your current user area, but CP/M- 
68K does not assume you supplied a filetype. 
Therefore, CP/M-68K first appends a filetype of 
68K to your filename and searches your current 
user area for the file. If filename.68K is found, 
CP/M-68K executes that file without invoking 
SUBMIT. 


2) If filename.68K is not found, CP/M-68K substitutes 
a blank filetype for the 68K filetype it appended 
to your filename and searches for this file 
specification in your current user area. If such 
a file exists, it is executed and SUBMIT is again 
bypassed. : 


3) If the file specification with the blank filetype 
is not found, CP/M-68K substitutes a SUB filetype 


for the blank filetype and searches for this file _ 


specification in your current user area. -.If 
filename.SUB is found, CP/M-68K recognizes that 
you want to execute a SUBMIT file; control passes 
to SUBMIT and SUBMIT tries -to execute your file. 


4) I£ CP/M-68K is unable to find any of the above 
combinations in your current user area, it 
searches user area 0 first for your filename.68K, 
then for your filename.<blank>, and finally for 
your filename.SUB. I£ none of these three file 
specifications are found in either the current 
user area or user area 0, CP/M-68K displays the 
command keyword followed by a question mark. 


If the fifth form is used, CP/M-68K prompts you for 
your file specification: 

Enter Filename: __ 

The underscore represents your cursor's position. 


You may then reply with a filename having a blank 
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filetype or with a filename having a filetype of SUB. 
If you provide a blank filetype, CP/M-68K appends the 
SUB filetype for you. If you provide any filetype 
other than SUB or blank, CP/M-68K rejects it as 
inappropriate for SUBMIT and asks you to supply a 
filename with a filetype of SUB or blank. 

If you enter only SUBMIT, the system prompts for the 
rest of the command. You enter the filespec and 
arguments. 

A>SUBMIT 

and the system prompts: 

Enter Filename: 

Enter the filespec and arguments here, such as 
START B TEX 

Another example could be: 


A>SUBMIT SUBA 
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5.11 The TYPE (Display File) Built-in 


Syntax: TYPE {filespec} 


° 
- 


. Explanation: The TYPE built-in command displays the contents of a 
character file on your screen. If the file occupies 
more than a screenful of space, TYPE scrolis-the file 
vertically up the screen. Press CTRL-S to stop the 
scrolling and CTRL-Q to resume. - Wildcards are not 
permitted with this command. — 


Tab characters occurring. in the file named by the 
file specification are expanded to every eighth 
column position of your screen. 


To abort the TYPE command while text is scrolling on 
your screen, press CTRL-C. 


Make sure the file specification identifies a file 
containing character data. 


- 


Examples: A>TYPE MYPROG.A86 


This command displays the contents of the file 
MYPROG.A86 on your screen. 


A>TYPE B: THISFILE 


This command displays the contents of the file 
THISFILE from drive B on your screen. 


TYPE can also be executed without first specifying 
the file specification in the command line. If you 
do this, TYPE prompts you for your file 
specification: : 


Enter Filename: __ 


The underscore represents your cursor's position. 
Respond with the file specification of the file whose 
contents you want to see displayed on your screen. 


If the file named by the file specification is not 
present on an on-line disk, TYPE displays the 
following message on your screen: 


NO FILE 
To list the file at the printer as well as on the 
screen, type a CTRL-P before entering the TYPE 


command line. To stop echoing keyboard input at the 
printer, type a second CTRL-P. 
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5.12 The USER (Set User Number) Command 


Syntax: USER {number} 

Explanation: The USER command sets the current user number. The 

ae disk directory can be divided into distinct groups 
according to a user number. User numbers range from 
0 through 15. 


When CP/M-68K starts, 0 is the current user number. 
Executable files created under user 0 are accessible 
from any other user number. Files that you create 
under any user number other than 0 are not accessible 
under any other user number, except through the PIP 
command. See the G option of the PIP Command. 


Example: A>USER 3 
3A> 
This command changes the current user number to 3. 
USER can.also be executed without specifying the user 
number in the command line. If you do this, USER - 
prompts you for your user new number. : 
Example: A>USER 
Enter User#: — . . 
The underscore represents your cursor's position. 
Respond with the user number you wish to make 


currents: 


Enter User#:5 
5A> 


The current user number is now 5 on drive A. 


‘ End of Section 5 


Section 6 
The CP/M-68K Editor 


6.1 Introduction to ED 


To do almost anything with a computer you need some way to 
enter data, some way to give the computer the information you want 
it to process. The programs most commonly used for this task are 
called editors. They transfer your keystrokes at the keyboard to a 
disk file. CP/M-68K'‘'s editor is named ED. Using ED, you can easily 
create and alter CP/M-68K text files. | 


The correct command syntax for invoking the CP/M-68K editor 
is given in Section 6.2, “Starting ED." After starting ED, you 
issue commands that transfer text from a disk file to memory for 
editing. “ED Operation" details this operation and describes the 
basic text transfer commands that allow you to easily enter and exit 
the editor. 


Section 6.4, “Basic Editing Commands" details the commands 
that edit a file. Section 6.5, “Combining ED Commands" describes 
how to combine the basic commands to edit more efficiently. 
Although you can edit any file with the basic ED commands, ED 
provides several more commands that perform more complicated editing 
functions, as described in Section 6.6, “Advanced ED Commands.” 


During an editing session, ED may return two types of error 
‘messages. Section 6.7, "ED Error Messages,” lists these messages 
and provides examples that indicate how to recover from common 
editing error conditions. 

6.2 Starting ED 


Syntax: 


ED filespec filespec 

To start ED, enter its name after the CP/M-68K prompt. The 
command ED must be followed by a file specification, one that 
contains no wildcard characters, such as: 


A>ED MYFILE.TEX 


The file specification, MYFILE.TEX in the above example, 
specifies a file to be edited or created. The file specification 
can be preceded by a drive specifier but a drive specifier is 
unnecessary if the file to be edited is on your default drive. 
Optionally, the file specification can be followed by a drive 
specifier, as shown in the following example. 


A>ED MYFILE.TEX B: 
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In response to this command, ED opens the file to be edited, 
MYFILE.TEX, on drive A, but sends all the edited material to a file 
on drive B. 


Optionally, you can send the edited material to a file with a 
different filename, as shown in the following example. 


A>ED MYFILE.TEX YOURFILE.TEX 


The file with the different filename cannot already exist or 
-ED prints ‘the following message and terminates. 


Output File Exists, Erase It 


The ED prompt, *, appears at the screen when ED is ready to accept a 
command, as shown below. 


A>ED MYFILE.TEX 


.« & 


If no previous version of the file exists on the current 
disk, ED automatically creates a new file and displays the following 
message: 


NEW FILE 
2 


Note: before starting an editing session, use the STAT command to 
check the amount of free space on your disk. Make sure that the 
unused portion of your disk is at least as large as the file you are 
editing or larger if you plan to add characters to the file. When 
ED finds a disk or directory full, ED has only limited recovery 
mechanisms. These are explained in Section 6.7, “ED Error 
Messages." , 


6.3 ED Operation 


With ED, you change portions of a file that pass through a 
memory buffer. When you start ED with one of the commands shown 
above, this memory buffer is empty. At your command, ED reads 
segments of the source file, for example MYFILE.TEX, into the memory 
buffer for you to edit. If the file is new, you must insert text 
into the file before you can edit. During the edit, ED writes the 
edited text onto a temporary work file, MYFILE.S$$§. 


When you end the edit, ED writes the memory buffer contents 
to the temporary file, followed by any remaining text in the source 
file. ED then changes the name of the source file from MYFILE.TEX 
to MYFILE.BAK, so you can reclaim this original material from the 
back-up file if necessary. ED then renames the temporary file, 
MYFILE.S$S$, to MYFILE.TEX, the new edited file. The following 
figure illustrates the relationship between the source file, the 
temporary work file and the new file. 
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Note: when you invoke ED with two filespecs, an input file and an 
output file, ED does not rename the input file to type .BAK; 
therefore, the input file can be Read-Only or on a write protected 
disk if the output file is written to another disk. 


Pigure 6-1. Overall ED Operation 
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In the figure above, the memory buffer is logically between 
the source file and the temporary work file. ED supports several 
commands that transfer lines of text between the source file, the 
memory buffer, and the temporary (and eventually final) file. The 
following table lists the three basic text transfer commands that 
allow you to easily enter the editor, write text to the temporary ' 
file, and exit the editor.- 


Table 6-1. Text Transfer Commands 


Append the next n unprocessed source lines 
from the source file to the end of the 
memory buffer. 


Write the first n lines of the memory 
buffer to the temporary file free space. 


End the edit. Copy all buffered text to 

the temporary file, and copy all 
a unprocessed source lines to the temporary 
file. Rename files. 


6.3.1 Appending Text into the Buffer 


When you start ED and the memory buffer is empty, you can use 
the A (append) command to add text to the memory buffer. 


Note: ED can number lines of text to help you keep track of data in 
the memory buffer. The colon that appears when you start ED 
indicates that line numbering is turned on. Type -V after the ED 
prompt to turn the line number display off. Line numbers appear on 
the screen but never become a part of the output file. 


The A_ (Append) Command 


The A command appends (copies) lines from an existing source 
file into the memory buffer. The form of the A command is 


nA 


where n is the number of unprocessed source lines to append into the 
memory buffer. If a pound sign, #, is given in place of n, than the 
integer 65535 is assumed. Because the memory buffer can contain 
most reasonably sized source files, it is often possible to issue 
the command #A at the beginning of the edit to read the entire 
source file into memory. 
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Tf n is 0, ED appends the unprocessed source lines into the 
memory buffer until the buffer is approximately half full. I£ you 


do not specify n, ED appends one line from the source file into the 
memory buffer. 


=> 


6.3.2 ED Exit 


You can use the W (Write) command and the E (Exit) command to 
save your editing changes. The W command writes lines from the 
memory buffer to the new file without ending the ED session. An E 
command saves the contents of the buffer and any unprocessed 
materiai from the source file and exits ED. 


The W (Write) Command 


The W command writes lines from the buffer to the new file. 
The form of the W command is 


nw 


where n is the number of lines. to be written from the beginning of 
the buffer to the end of the new file. If n is greater than 0, ED 
writes n lines from the beginning of the buffer to the end of the 
new file. If n is 0, ED writes lines until the buffer is half 
empty. The OW command is a convenient. way of making room in the 
Memory buffer for more lines from the source file. You can 
determine the number of lines to write out by executing a 0V command 
to check the amount of free space in the buffer, as shown below: 


1: *0V 
25000/30000 
1: * 


The above display indicates that the total size of the memory buffer 
is 30,000 bytes and there are 25,000 free bytes in the memory 
buffer. 


Note: after a W command is executed, you must enter the H command 
to reedit the saved lines during the current editing session. 


The E (Exit) Command 


An E command performs a normal exit from ED. The form of the 
E command is 


E 
followed by a carriage return. 
When. you enter an E command, ED first writes all data lines 


from the buffer and the original source file to the new file. Ifa 
-BAK file exists, ED deletes it, then renames the original file with 
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the .BAK filetype. Finally, ED renames the new file from 
filename.$$$ to the original filetype and returns control to the 
CCP. 


The operation of the E command makes it unwise to edit a 
back-up file. When you edit a BAK file and exit with an E command, 
ED erases your original file because it has a .BAK filetype. To 
avoid this, always rename a back-up file to some other filetype 
before editing it with ED. 


Note: any command that terminates an ED session must be the only 
command on the line. 


6.4 Basic Editing Commands 


The text transfer commands discussed above allow you to easily 
enter and exit the editor. This section discusses the basic 
. commands that edit a file. 


ED treats a file as a long chain of characters grouped together 
in lines. ED displays and edits characters and lines in relation to 
an imaginary device called the character pointer (CP). During an 
edit session, you must mentally picture the CP's location in the 
memory buffer and issue commands to move the CP and edit the file. 


The following commands move the character pointer or display 
text in the vicinity of the CP. These ED commands consist of a 
numeric argument and a single command letter and must be followed by 
a carriage return. The numeric argument, n, determines the number 
of times ED executes a command; however, there are four special 
' eases to consider in regard to the numeric argument: 


e If the numeric argument is omitted, ED assumes an argument of 
l. 


@ Use a negative number if the command is to executed backwards 
through the memory buffer. (The B command is an exception). 


@ If you enter a pound sign, #, in place of a number, ED uses the 
value 65535 as the argument. A pound sign argument can be 
preceded by a minus sign to cause the command to execute 
backwards through the memory buffer (-#). 


e ED accepts 0 as a numeric argument only in certain commands. 
In some cases, 0 causes the command to be executed 
approximately half the possible number of times, while in other 
cases it prevents the movement of the CP. 
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The following table alphabetically summarizes the basic editing 
commands and their valid arguments. 


Table 6-2. Basic Editing Commands 


Move CP to the beginning (B) or end (=-B) 
of the memory buffer. 


Move CP n characters forward (nC) or 
backward (-nC) through the memory buffer. 


Delete n characters before (-nD) or after 
(nD) the CP. 


Enter insert mode. 
IstringTzZ Insert a string of characters. 


nK, -nK Delete (kill) n lines before the CP (~nK) 
or after the CP (nK). 


nL, -nL Move the CP n lines forward (nL) or 
backward (-nL) through the memory buffer. 


nT, -nT Type n lines before the CP (-nT) or after 
the CP (nT). 


n, “=n Move the CP n Lines before the CP (-n) or 
after the CP .(n) and display the 
destination line. 


The following sections discuss ED‘s basic editing commands in 
more detail. The examples in these sections illustrate how the 
commands affect the position of the character pointer in the memory 
buffer. Later examples in Section 6.5, “Combining ED Commands,” 
illustrate how the commands appear at the Screen. Por these 
sections, however, the symbol “* in command examples represents the 
character pointer, which you must imagine in the memory buffer. 


6.4.1 Moving the Character Pointer 


This section describes commands that move the character pointer 
in useful increments but do not display the destination line. 
Although ED is used primarily to create and edit program source 
files, the following sections present a simple text as an example to 
make ED easier to learn and understand. 
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The B_ (Beginning/Bottom) Command 


The B command moves the CP to the beginning or bottom of the 
memory buffer. The forms of the B command are 


B, -B 


-B moves the CP to the end or bottom of the memory buffer; B moves 
the CP to the beginning of the buffer. 


The C (Character) Command 


The C command moves the CP forward or backward the specified 
number of characters. The forms of the C command are 


nc, -nc 


where n is the number of characters the CP is to be moved. A 
positive number moves the CP towards the end of the line and the 
bottom of the buffer. A negative number moves the CP towards the 
beginning of the line and the top of the buffer. You can enter ann 
large enough to move the CP to a different line. However, each line 
is separated from the next by two invisible characters: a carriage- 
return and a line-feed represented by <cr><lf>. You must compensate 
for their presence. For example, the command 30C moves the CP to 
the next line: 


Emily Dickinson said,<cr><lf> ; 
"I fin*d ecstasy in living ~<cr><lf> 


The L (Line) Command 


The L command moves the CP the specified number of lines. 
After an L command, the CP always points to the beginning of a line. 
The forms of the L command are 


nL, -nb 


where n is the number of lines the CP is to be moved. A positive 
number moves the CP towards the end of the buffer. A negative 
number moves the CP back toward the beginning of the buffer. The 
command 2L moves the CP two lines forward through the memory buffer 
and positions the character pointer at the beginning of the line. 


Emily Dickinson said,<cr><lf> 
"I find ecstasy in living -<cer><lf> 
“the mere sense of living<cr><lf> 


The command -L moves the CP to the beginning of the previous line, 
even if the CP originally points to a character in the middle of the 
line. Use the special character 0 to move the CP to the beginning 
of the current line. 


NN. 
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The n (Number) Command 


The n command moves the CP and displays the destination line. 
The forms of the n command are 


n, -n 


where n is the number of lines the CP is to be moved. In response 
to this command, ED moves the CP forward or backward the number of 
lines specified, then prints only the destination line. 


Emily Dickinson said,<cr><lf£> 
“"I find ecstasy in living ~<cr><lf> 


A further abbreviation of this command is to enter no number at all. 
In response to a carriage return without a preceding command, ED 
assumes an n command of 1 and moves the CP down to the next line and 
prints it. 


Emily Dickinson said,<cer><lf£> 
“"t find ecstasy in living -<cr><lf£> 


Also, a minus sign, -, without a number moves the CP back one line. 


6.4.2 Displaying Memory Buffer Contents 


ED does not display the contents of the memory buffer until you 
specify which part of the text you want to see. The T command 
displays text without moving the CP. | 


The T e) Command 


The T command types a specified number of lines from the CP at 
the screen. The forms of the T command are 


nt e -nTt 


where n specifies the .number of lines to be displayed. If a 
negative number is entered, ED displays n lines before the CP. A 
positive number displays n lines after the CP. If no number is 
specified, ED types from the character pointer to the end of the 
line. The CP remains in its original position no matter how many 
lines are typed. For example, if the character pointer is at the 
beginning of the memory buffer, and you instruct ED to type four 
lines (4T), four lines are displayed at the eceseny but the. CP stays 
at the beginning of line l. 


“Emily Dickinson said, <cr><lf> 
"I find ecstasy in living -<cr><lf> 


the mere sense of living 
is joy enough." _ 
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If the CP is between two characters in the middle of the line, T 
command with no number specified types only the characters between 
the CP and the end of the line, but the character pointer stays in 
the same position, as shown in the memory buffer example below. 


"I find ecstasy in living - 


Whenever ED is displaying text with the T command, you can enter a. 
CTRL-S to stop the display, then a CTRL-Q when you're ready to 
continue scrolling. Enter a CTRL-C to abort long type-outs. 


6.4.3 Deleting Characters 


The D (Delete) Command 


The D command deletes a specified number of characters and has 
the forms: - 


nD, -nD 


where n is the number of characters to be deleted. If no number is 
specified, ED deletes the character to the right of the CP. A 
positive number deletes multiple characters to the right of the CP, 
towards the bottom of the file. A negative number deletes 
characters to the left of the CP, towards the top of the file. If 
the character pointer is positioned in the memory buffer as shown 
below: 


“ Emily Dickinson said,<cr><lf£> 
“I find ecstasy in living ~-<cr><lf> 
the mere sense of living<cer><lf> 
is joy “enough. *<cr><lf> 


the command 6D deletes the six characters after the CP, and the 
resulting memory buffer looks like this: 


Emily Dickinson said, <cr><lf> 
"I find ecstasy in living —<cr><l£> 
the mere sense of lLiving<cr><lf> 
is joy *."<cr><lf> 
You can also use a D command to delete the <cr><lf> between two 


lines to join them together. Remember that the <cr> and <lf> are 
two characters. 


The K (Kill) Command 


The K command kills or deletes whole lines from the memory 
buffer and takes the forms: 


nk ’ -nKk 


where n is the number of lines to be deleted. A positive number 
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kills lines after the CP. A negative number kills lines before the 
CP. When no number is specified, ED kills the current line. If the 
character pointer is at the beginning of the second line (as shown 
below), 


Emily Dickinson said,<cr><lf£> 

“"I find ecstasy in living ~<cr><lf> 
‘the mere sense of Living<cr><lf> 

is joy enough."<cr><lf> 


then the command -K deletes the previous line and the memory buffer 
changes: 


“"I find ecstasy in living -~<cr><lf> 
the mere sense of lLiving<cr><lf> 
is joy enough."<cr><lf£> 


If the CP is in the middle of a line, a K command kills only 
the characters from the CP to the end of the line and concatenates 
the characters before the CP with the next line. A -K command 
deletes all the characters between the beginning of the previous 
line and the CP. A OK command deletes the characters on the line up 
to the CP. ; 


You can use the special # character to delete all the text from 
the CP to the beginning or end of the buffer. Be careful when using 
#K because you cannot reclaim lines after they are removed from the 
memory buffer. an 


6.4.4 Inserting Characters into the Memory Buffer 


The I (Insert) Command 


To insert characters into_the memory buffer from the screen, 
use the I command. The I command takes the forms: 


I 
Istring*Z 


When you type the first command, ED enters insert mode. In this 
mode, all keystrokes are added directly to the memory buffer. ED 
enters characters in lines and does not start a new line until you 
press the enter key. 


A>ED B:QUOTE.TEX 


NEW FILE 
2 81 
1: Emily Dickinson said, 
2: “I find ecstasy in living - 
3: the mere sense of living 
4: is joy enoagh.* 
5: .2 


> 
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Hote: to exit from insert mode, you must press CTRL~Z or Esc. When 
the ED prompt, *, appears on the screen, ED is not in insert mode. 


In command mode, you can use CP/M-68K line editing control 
characters to edit your input. The table below lists these control 
characters. ; 9 


Table 6-3. CP/M-68K Line Editing Controls 


CTRL-C Abort the editor and return to the CP/M- 
68K system. 


CTRL-E Return carriage for long lines without 
transmitting command line to the buffer. 


CTRL-H Delete the last character typed on the 
current line. 


CTRL-U Delete the entire line currently being 
typed. é 


CTRL-X : Delete the entire line currently being 
typed. Same as CTRL-U. — 


Rubout Remove the last character and echo deleted 
character at the screen. 


Note: in insert mode, the same line editing controls exist except 
for CTRL-C and CTRL-E. 


When entering a combination of numbers and letters, you might 
find it inconvenient to press a caps-lock key if your terminal 
translates caps-locked numbers to special characters. ED provides 
two ways to translate your alphabetic input to upper-case without 
affecting numbers. The first is to enter the insert command letter 
in upper-case: I. All alphabetics entered during the course of the 
capitalized command, either in insert mode or as a string, are 
translated to upper-case. . (If you enter the insert command letter 
in lower-case, all alphabetics are inserted as typed). The second 
method is to enter a-U command before inserting text. Upper-case 
translation remains-in effect until you enter a -U command. 


The Istring”Z (Insert Strin Command 


The second form of the I command does not enter insert mode. 
It inserts the character string into the memory buffer and returns 
immediately to the ED prompt. You can use CP/M-68K's line editing 
control characters to edit the command string. 
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To insert a string, first use one of the commands that position 
the CP. You must move the CP to the place where you want to insert 
a string. For example, if you want to insert a string at the 
beginning of the first Line, use a B command to move the CP to the 
beginning of the buffer. With the CP positioned correctly, enter an 
insert string, as shown below: 


iIn 1870, “Z. 
This inserts the phrase “In 1870, “ at the beginning of the first 
line, and returns immediately to the ED prompt. [In the memory 
buffer, the CP appears after the inserted string, as shown below: 


In 1870, “Emily Dickinson said,<cr><l£> 


6.4.5 Replacing Characters) 


The S (Substitute) Command 


The S command searches the memory buffer for the specified 
string, but when it finds it, automatically substitutes a new string 
for the search string. The S command takes the form: 


nSsearch string*Znew string 


where n is the number of substitutions to make. If no number is 
specified, ED searches for the next occurrence of the search string 
in the memory buffer. For example, the command: 


Emily Dickinson*ZThe poet 


searches for the first occurrence of “Emily Dickinson" and 
substitutes “The poet.” In the memory buffer, the CP appears after 
the substituted phrase, as shown below: 


The poet~ said,<cr><lf> 


If upper-case translation is enabled by a capital S command 
letter, ED looks for a capitalized search string and inserts a 
capitalized insert string. Note that if you combine this command 
with other commands, you must terminate the new string with a CTRL- 
Z. : 


6.5 Combining ED Commands ~ 


It saves keystrokes and editing time to combine the editing and 
display commands. You can type any number of ED commands on the 
same line. ED executes the command string only after you press the 
carriage-return key. Use CP/M-68K's line editing controls to 
manipulate ED command strings. 


~ 
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When you combine several commands on a line, ED executes them 
in the same order they are entered, from left to right on the 
command line. There are four restrictions to combining ED commands: 


e The combined-command line must not exceed CP/M-68K's 128 
character maximun,. : ) 


@ If the combined-command line contains a character string, the 
line must not exceed 100 characters. 


e Commands to terminate an editing session must not appear ina 
combined-command line. 


e Commands, such as the I, J, R, S, and X commands, that require 
character strings or filespecs must be either the last command 
on a line or must be terminated with a CTRL-Z or Esc character, 
even if no character string or filespec is given. 


While the examples in the previous section show the memory 
buffer and the position of the character pointer, the examples in 
this section show how the..screen looks during an editing session. 
Remember that the character pointer is imaginary, but you must 
picture its location because ED's commands display and edit text in 
relation to the character pointer. 


6.5.1 Moving the Character Pointer _ ae . . 


To move the CP to the end of a line without calculating the 
number of characters, combine an L command with a C command, L-2C. 
This command string accounts for the <cr><lf> sequence at the end of 
the line. z 

Change the C.command in this command string to move the CP more 
characters to the left. You can use this command string if you must 
make a change at the end of the line and you don't want to calculate 
the number of characters before the change, as in the following 
example. 


Emily Dickinson said, 
*L-—7CT 


me 
ee ce 0 


said 
x 


ee 
ee 


6.5.2 Displaying Text 


A T command types from the CP to the end of the line. To see a 
the entire line, you can combine an L command and a T command. Type 
Qlt to move the CP from the middle to the beginning of the line and 
then display the entire line. In the example below, the CP is in 
the middle of the-line. OL moves the CP to the beginning of the 


wages wwes ew we —- -se ee + eee ee ee 


line. T types from the CP to the end of the line, allowing you to 
see the entire line. 


3: *f 
sense of living 
3: **QLT 
3: the mere sense of living 
3:3 * 


The command OTT displays the entire line without moving the CP. 


To verify that an ED command moves the CP correctly, combine 
the command with the T command to display the line. The following 
example combines a C command and a T command. 


: *8CcT 
ecstasy in living - 
® 


: *BeTt 

l: Emily Dickinson said, 
: "I find ecstasy in living - 
s the mere sense of living 

: is joy enough." 

e . 3 


6.5.3 Editing 


To edit text and verify corrections quickly, combine the edit 
commands with other ED commands that move the CP and display text. 
Command strings like the one below move the CP, delete eeecrttes 
characters, and verify changes quickly. 


1: *1S5CSDOLT 
ls: Emily Dickinson, 
is. -* 


Combine the edit command K with other ED commands to delete entire 
lines and verify the correction quickly, as shown below. 


l: *2L2KBéT 

l: Emily Dickinson said, 

2: *I find ecstasy in living - 
1: ? 


The abbreviated form of the I (insert) command makes simple textual 
changes. To make and verify these changes, combine the I command 
string with the C command and the OLT command string as shown below. 
Remember that the insert string must be terminated by a CTRL-Z. 


l: *20Ci to a friend*ZOLT 
ls: Emily Dickinson said to a friend, 
Le * 
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6.6 Advanced ED Commands 


The basic editing commands discussed above allow you to use ED 
for all your editing. The following ED commands, however, enhance 
ED's usefulness. ." 


6.6.1 Moving the CP and Displayiag Text 
The P_ (Page) Command 


Although you can display any amount of text at the screen with 
a T command, it is sometimes more convenient to page through the 
buffer, viewing whole screens of data and moving the CP to the top 
of each new screen at the same time. To do this, use ED's P 
command. The P command takes the following forms: 


nP ’ ~-nP 


where n is the number of pages to be displayed. If you do not 
specify n, ED types the 23 lines following the CP and then moves the 
CP forward 23 lines. This leaves the CP pointing to the first 
character on. the screen. 


To display the current page without moving the CP, enter OP. 
The special character 0 prevents the movement of the CP. If you 
specify a negative number for n, P pages backwards towards the top 
of the file. 


The n: (Line Number) Command ; 


When line numbers are being displayed, ED accepts a line number 
as a command to specify a destination for the CP. The form for the 
line number command is 


ne 


where n is the number of the destination line. This command places 
the CP at the beginning of the specified line. For example, the 
command 4: moves the CP to the beginning of the fourth line. 


Remember that ED dynamically renumbers text lines in the buffer 
each time a line is added: or deleted. Therefore, the number of the 
destination line you have in mind can change during editing. 


FRET STEEP TAN 
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The :n (Through Line Number) Command 


The inverse of the line number command specifies that a command 
should be executed through a certain line number. You can only use 
this command with three ED commands: the T (type) command, the L 
(line) command, and the K (kill) command. The :n command takes the 
following form: 


:ncommand 


where n is the line number through which the command is to be 
executed. The :n part of the command does not move the CP, but the 
command that follows it might. 


You can combine n: with :n to specify a range of lines through 
which a command should be executed. For example, the command 2::4T 
types the second, -third, and fourth lines, as shown below. 


1: *2::4T 

2: "I find ecstasy in living - 
3: the mere sense of living 

4: is joy enough." 

2: * 


a 


6.6.2 Finding and Replacing Character Strings 


ED supports a find command, F, that. searches through the memory 
buffer and places the CP after the word or phrase you want. The N 
command allows ED to search through the entire source file instead 
of just the buffer. The J command searches for and then juxtaposes 
character strings. 


The F (Find) Command 


The F command performs the simplest find function. Its form is 
nPstring 


where n is the occurrence of the string to be found. Any number you 
enter must be positive because ED can only search from the CP to the 
bottom of the buffer. If you enter no number, ED finds the next 
occurrence of the string in the file. In the following example, the 
second occurrence of the word living is found. 


l: *2fliving 
3: * 


The character pointer moves to the beginning of the third Line where 
the second occurrence of the word "living" is located. To display 
the line, combine the find command with a type command. Note that 
if you follow an F command with another command on the same line, 
you must terminate the string with a CTRL-Z, as shown below. 
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lL: *2£fliving“Zz01t 
3: *the mere sense of living 


It makes a difference whether you enter the F command in upper- or 
lower-case. If you enter F, ED internally translates the argument 
String to upper-case. If you specify f, ED looks for an exact 
match. For example, FCp/m-68k searches for CP/M-68K but fCp/m-68k 
searches for Cp/m-68k and cannot find CP/M-68K, or cp/m-68K. 


If ED does not find a match for the string in the memory 
buffer, it issues the message: 


BREAK “#" AT 


where the symbol # indicates that the search failed during the 
execution of an F command. 


The N Command 


The N command extends the search function beyond the memory 
buffer to include the source file. If the search is successful, it 
leaves the CP pointing to the first character after the search 
String. The form of the N command is 


nNstring 


. where n is the occurrence of the string to be found. If no number 
-is entered, ED looks for the next occurrence of the string in the 
file. The case of the N command has the same effect on an N command 
as it does on an F command. Note that if you follow an N command 
with another ED command, you must terminate the string with a CTRL- 
Ze 


When an N command is executed, ED searches the memory buffer 
for the specified string, but if ED does not find the string, it 
does not issue an error message. Instead, ED automatically writes 
the searched data from the buffer into the new file. Then ED 
‘performs a OA command to fill the buffer with unsearched data from 
the source file. ED continues to search the buffer, write out data 
and append new data until it either finds the string or reaches the 
end of the source file. If ED reaches the end of the source file, 
ED issues the following message: 


BREAK “#" AT 


- Because ED writes the searched data to the new file before looking 


for more data in the source file, ED usually writes the contents of 
the buffer to the new file before finding the end of the ‘source file 
and issuing the error message. 


Note: you must use the H command to continue an edit session after 
the source file is exhausted and the memory buffer is emptied. 
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The J (Juxtapose) Command 


The J command inserts a string after the search string, then 
deletes any characters between the end of the inserted string to the 
beginning of the third delete-to string. This juxtaposes the string 
between the search and delete-to strings with the insert string. 
The form of the J command is : 


, 


nJsearch string*Zinsert string*Zdelete-to string 


where n is the occurrence of the search string. If no number is 
specified, ED searches for the next occurrence of the search string 


in the memory buffer. In the following example, ED searches for the. 


word "Dickinson" and inserts the phrase "told a friend" after it and 
then deletes everything up to the comma. 


l: *§f 

l: Emily Dickinson said, 

: “I find ecstasy in living - 

: the mere sense of living 

: is joy enough." 
l: *3Dickinson“Z told a friend“Z, 
: *01lt 

: Emily Dickinson told a friend, 
. ® 


I€ you combine this command with. other commands, you ‘must 
terminate the delete-to string with a CTRL-Z or Esc. (This is shown 


in the following example). If an upper-case J command letter is. 


specified, ED looks for upper-case search and delete-to strings and 
inserts an. upper-case insert string. 


The J command is especially useful when revising comments in 
assembly language source code, as shown below. 


236: SORT LXI H, SW ; ADDRESS TOGGLE SWITCH 
236: *3j;“ZADDRESS SWITCH TOGGLE”“2°L“Z0LT 

236: SORT LXI H, SW ; ADDRESS SWITCH TOGGLE 
236: * 


In this example, ED searches for the first semicolon and inserts 
ADDRESS SWITCH TOGGLE after the mark and then deletes to the 
<cr><lf> sequence, represented by CTRL-L. (In any search string, 
you can use CTRL-L to represent a <cr><lf> when your desired phrase 
extends across a line break. You can also use a CTRL-I in a search 
String to represent a tab). 


Note: if long strings make your command longer than your screen 
line length, enter a CTRL-E to cause a physical carriage return at 
the screen. A CTRL-E returns the cursor to the left edge of the 
screen, but does not send the command line to ED. Remember that no 
ED command line containing strings can exceed 100 characters. When 
you finish your command, press the carriage-return key to send the 
command to ED. 
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The M (Macro) Command 


An ED macro command, M, can increase the usefulness of a string 
of commands. The M command allows you to group ED commands together 
for repeated execution. The form of the M command is 

= 


nMcommand string ss 


where n is the number of times the comvaand string is to be executed. 
A negative number is not a valid argument for an M command. If no 
number is specifed, the special character # is assumed, and ED 
executes the command string until it reaches the end of data in the 
buffer or the end of the source file, depending on the commands 
specified in the string. In the following example, ED executes the 
four commands repetitively until it reaches the end of the memory 
buffer: 


l: *mfliwing~2-G6diLiving*z01t 
2: “I find ecstasy in Living - 
3: the mere sense of Living 


BREAK “#" AT “Z 
St & 
The terminator for an M command is a carriage return; therefore, an 
‘M command must be the last command on the line. Also, all character 
strings that appear in a macro must be terminated by CTRL-Z or Esc. 
If a character string ends the combined-command string, it must be 
terminated by CTRL-Z, then followed by a <cr> to end the M command. 


The execution of a macro command always ends in a BREAK “#" 
message, even when you have limited the number of times the macro is 
to be performed, and ED does not reach the end of the buffer or 
source file. Usually the command letter displayed in the message is 
one of the commands from the string and not M. 


To abort a macro command, strike a CTRL-C at the keyboard. 


6.6.3 Moving Text Blocks 


To move a group of lines from one area of your data to another, 
use an X command to write the text block into a temporary .LIB file, 
then a K command to remove these lines from their original location, 
and finally an R command to read the block into its new location. 


The X (Transfer) Command 


The X command takes the forms: 


nx 
nx filespec*zZ 


where n is the number of lines from the CP towards the bottom of the 
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buffer that are to be transferred to a temporary file; therefore, n 
must always be a positive number. If no filename is specified, 
XSSSSSSS is assumed. If no filetype is specified, .LIB is assumed. 
If the X command is not the last command on the line, the command 
must be terminated by a CTRL-Z or Esc. In the following example, 
just one line is transferred to the temporary file: 


lz *X 

l: *t 

l: *Emily Dickinson said, 

Ls: *kt 

l: *"I find ecstasy in living - 
Ll: * . 


If no library file is specified, ED looks for a file named 
XSSSSSS$.LIB. If the file does not exist, ED creates it. [If a 
previous X command already created the library file, ED appends the 
specified lines to the end of the existing file. 

Use the special character 0 as the n argument in an X command 
to delete any file from within ED. 

The R (Read) Command 


The X command transfers the next n lines from the current Line 


to a library file. The R command can retrieve the eansterred 


lines. The R command takes the forms: 


R 
R£ilespec 


If no filename is specified, XS$S$$$$$$ is assumed. If no filetype is 
specified, .LIB is assumed. R inserts the library file in front of 
the CP; therefore, after the file is added to the memory buffer, 
the CP points to the same character it did before the read, although 
the character is on a new line number. If you combine an R command 
with other commands, you mst separate the filename from subsequent 
command letters with a CTRL-Z as in the following example where ED 
types the entire file to verify the read. 


l: *41 
: *R°ZBEeP : 
l: “°I find ecstasy in living - 
2: the mere sense of living 
3: is joy enough." 
4: Emily Dickinson said, 
l: * 
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6.6.4 Saving or Abandoning Changes: ED Exit 


You can save or abandon editing changes with the following 
three commands. 


The H (Head of File) Command 


An H command saves the contents of the memory buffer without 
ending the ED session, but it returns to the “head" of the file. It 
saves the current changes and lets you reedit the file without 
exiting ED. The form of the H command is 


= § 
followed by a carriage return. 


To execute an H command, ED first finalizes the new file, 
transferring all lines remaining in the buffer and the source file 
to the new file. Then ED closes the new file, erases any .BAK file 
that has the same file specification as the original source file, 
and renames the original source file filename.BAK. ED then renames 
the new file, which has had the filetype .$$$, with the original 
file specification. Finally, ED opens the newly renamed file as the 
new source file for a new edit, and opens a new .$$$ file. When ED 
returns the * prompt, the CP is at the beginning of an empty memory 
buffer. : 


-. I£€ you want to send the edited material to a file other than 
the original file, use the following command: 


A>ED filespec differentfilespec 


If you then restart the edit with the H command, ED renames the 
file differentfilename.$$$ to differentfilename.BAK and creates a 
new file of differentfilespec when you finish editing. 


The O (Original) Command 


An O command abandons changes made since the beginning of the 
edit and allows you to return to the original source file and begin 
reediting without ending the ED session. The form of the 0 command 
is , 


N 


ie} 


followed by a carriage return. When you enter an O command, ED 
confirms that you want to abandon your changes by asking: 


0 (Y/N)? 


You must respond with either a Y or an N; if you press any other 
key, ED repeats the question. When you enter Y, ED erases the 
temporary file and the contents of the memory buffer. When the * 


ee 
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prompt returns, the character pointer is pointing to the beginning 
of an empty memory buffer, just as it is when you start ED. 


The Q (Quit) Command 


AQ command abandons changes made since the beginning of the ED 
session and exits ED. The form of the Q command is 


Q 


followed by a carriage return. 


When you enter a Q command, ED verifies that you want to 
abandon the changes by asking: . 


Q (Y/N)? 


You must respond with either a Yor an N; if you press any 
other key, ED repeats the question. When you enter Y, ED erases the 


temporary file, closes the source file, and returns control to CP/M- 
68K. 


Note: you Can enter a CTRL-C to immediately return control to CP/M- 
68K. This does not give ED a chance to close the source or new 
files, but it prevents ED from deleting any temporary files. 


6.7 ED Error Messages 
ED returns one of two types of error messages: an ED error 
message if ED cannot execute an edit command, or a CP/M-68K error 
message if ED cannot read or write to the specified file. 
The form of an ED error message is 
BREAK "x" AT c 


where x is one of the symbols defined in the following table and c 
is the command letter where the error occurred. 


CP/M-68K User's Guide o./ BY BOLUL moeavayce 


Table 6-4. ED Error Symbols 


Search failure. ED cannot find the string 
specified in an F, S, or N command. 


Unrecognized command letter c. ED does not 
recognize the indicated command letter, or an 
E, H, Q, or O command is not alone on its 
command line. 


No .LIB file. ED did not find the .LIB file 
specified in an R command. 


Buffer full. ED cannot put any more characters 
in the memory buffer, or string specified in an 
F, N, or S command is too long. 


Command aborted. A keystroke at the keyboard 
aborted command execution. 


File error. Followed by either DISK FULL or 
DIRECTORY FULL. 


The following examples show how to recover from common editing 
error conditions. For example, 


BREAK ">" AT A. 


means that ED filled the memory buffer before completing the 
execution of an A command. When this occurs, the character pointer 
is at the end of the buffer and no editing is possible. Use the OW 
command to write out half the buffer or use an O or H command and 
reedit the file. : 


BREAK "#" AT F 


' means that ED reached the end of the memory buffer without matching 
the string in an F command. At this point, the character pointer is 
at the end of the buffer. Move the CP with a B or n: line number 
command to resume editing. 


BREAK “F" AT F 
DISK FULL 


Use the 0X command to erase an unnecessary file on the disk or 
a B¢Xd:buffer.sav command to write the contents of the memory buffer 
onto another disk. 
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BREAK “F" AT n 
DIRECTORY FULL 


Use the same commands described in the previous message to recover 
from this file error. 


The following table defines the disk file error messages ED 
returns when it cannot read or write a file. 


Table 6-5. ED Disk Pile Error Messages 


Message Meaning 


BDOS ERR ON d: RO 


Disk d: has Read-Only attribute. This 
occurs if a different disk has been 
inserted in the drive since the last cold 
or warm boot. 


** FILE IS READ ONLY ** 


The file specified in the command to 
invoke ED has the RO attribute. ED can 
read the file so that you can examine it, 
but ED cannot change a Read-Only file. 


End of Section 6 


Appendix A 
Error Messages 


Error messages come from several different sources. Each 
utility supplied with CP/M-68K has its own set of error messages. 
These mesSages are displayed when there are errors in the utility 
command lines. CP/M-68K also displays error messages when there are 
errors in calls to its built-in system modules: the Basic Disk 
Operating System (BDOS), the Basic I/O System (BIOS), and the 
Console Command Processor (CCP). The BDOS provides functions that 
access the file system, the BIOS provides functions that interface 
the peripheral device drivers for I/O processing, and the CCP 
provides the user interface that parses the user command line. 


The utility error messages and the CP/M-68K system error 
messages are listed below in alphabetic order with explanations and 
suggested user responses. The utility or system module that returns 
the error message is indicated in the explanation. I£ you are 
running an application program, you may see messages Other than 
those listed here. Check the application program's documentation 
for explanations of those messages. 


Table A-l. CP/M-68K Error Messages 


Message Meaning 


BAD DIRECTORY ON D: 
SPACE ALLOCATION CONFLICT 


STAT error. This message is followed by a list 
of one or more filenames. The files listed 
have been doubly allocated and contain data 
blocks that are already allocated to another 
file on the disk. The error can be caused by 
either a hardware or software failure. 


If you have maintained a backup disk with 
copies of your files, ERAse the affected files 
and reboot CP/M-68K. Rebooting the system 
cleans up the directory by reconstructing 
directory allocation vectors. If you do 
reboot the system the error will reoccur. 
replace the files you erased, COPY or PIP 
files from your backup disk. 
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Table A-l. (continued) 


Message Meaning 


If you do not have a back-up disk, you must 
recreate the doubly allocated files. If you 
can tell by careful checking which portions of 
the files are duplicated or deleted, you can 
reCOPY or PIP the files from the doubly 
allocated disk onto a new disk. Use ED to 
recreate the deleted portions and to delete the 
parts that were added to the wrong files. To 
clean up the doubly allocated disk so that it 
can be used again, ERAse it completely (ERA 
*.*) and reboot CP/M-68K. 


The problem that caused this error may or may 
not reoccur. If you were running an undebugged 
program at the time the error occurred, check 
the program carefully for an error that may 
have caused the space allocation error. If you 
were running a program that has been debugged 
and has caused no problem before, check your 
hardware. The error may have been caused by a 
damaged drive or loose connection. If the 
problem persists, contact your technical 
support personnel or the place you purchased ° 
your system for further assistance. 


bad relocation information bits 


CCP error. This message is a result of a BDOS 
Program Load Function 59 error. See the CP/M- 
68K Operating System Programmer's Guide for 
more information on Function 59. The message 
indicates that the file specified in the 
command line is not a valid executable command 
file, or that the file has been corrupted. 


Ensure that the file is a command file. 
Section 3 of this manual describes the format 
of a command file. If the file has been 
corrupted, reassemble or recompile the source 
file, and relink it before you reenter the 
command line. 
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Tabie A-l. (continued) 
Message Meaning 
BIOS ERROR -—- DISK x NOT SUPPORTED 


BIOS error. The disk drive indicated by the 
variable X is not.supported by the BIOS. The 
BDOS supports a maximum of 16 drives, lettered 
A through P. Check the documentation provided 
by the manufacturer for your system 
configuration to find out which of the BDOS 
drives your BIOS implements. Specify the 
correct drive code and reenter the command 
line. 


BIOS ERROR —— Invalid Disk Status 


BIOS error. The disk controller returned 

unexpected or incomprehensible information to 

the BIOS. Retry the operation. If the error 

persists, check the hardware. Tf the error — 
does not come from the hardware, it is caused 

by an error in the internal logic of the BIOS. 

Contact the place you purchased your system for 

assistance. You should provide the following 

information: 


@ Indicate which version of the operating 
system you are using. 


Describe your system's hardware 
configuration. 


Provide sufficient information to reproduce 
the error. Indicate which program was 
cunning at the time the error occurred. If 
possible, you should also provide a disk with 
a copy of the program. 
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Table A-l. (continued) 


Message Meaning 


BREAK "x" AT c 


ED error. Where “x” is one of the symbols 
described below and c is the command letter 
being executed when the error occurred. 


# Search failure. ED cannot find the string 
specified in a F, S, or N command. 


Unrecognized command letter c. ED does 
not recognize the indicated command 
letter, or an E, H, Q, or O command is not 
alone on its command line. 


The file specified in a R command could 
not be found. 


Buffer full. ED cannot put any more 
characters in the memory buffer, or the 
string specified in an F, N, or S command 
is too long. 


Command aborted. A keystroke at the 
console aborted command execution. 


Disk or directory full. This error is 
followed by either the disk or directory 
full message. Refer to the recovery 
procedures listed under these messages. 


CANNOT EDIT WILDCARD FILENAME 


ED error. A wildcard (*) filename was 
requested when invoking ED. ED does not 
support wildcard filenames as sources. 
Request a specific filename and reenter the ED 
command line. 
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A .CP/M=-o8K Error Messages 


Message Meaning _ 


Ro NNR | = rm ee 


CP/M Disk change error on drive x 


Disk error. The disk in the drive indicated by 
the variable x is not the same disk the system 
logged in previously. When the disk was 
replaced, you did not enter a CTRL-C to log in 
the current disk. Therefore, when you 
attempted to write to, erase, or rename a file 
on the current disk, the BDOS set the drive 
status to Read-Only and'warm booted the system. 
The current disk in the drive was not 
overwritten. The drive status was returned to 
Read-Write when the system was warm booted. 


Each time a disk is changed, you must type a 
CTRL-C to log in the new disk. 


CP/M Disk file error: filename is read-only. 
Do you want to: Change it to read/write (C), 
or Abort (A)? 


Disk error. You attempted to write to, erase, 
or rename a file whose status is Read-Only. 
Specify ome of the options enclosed in 
parentheses. If you specify the C option, the 
BDOS changes the status of the file to Read- 
Write and continues the operation. The Read~- 
Only protection previously assigned to the file 
is lost. If you specify the A option or a 
CTRL-C, the program terminates and CPM-68K 
returns the system prompt. 


CP/M Disk read error on drive x 
Do you want to: Abort (A), Retry (R), 
or Continue with bad data (C)? 


BDOS error. This message indicates a hardware 
error. Specify one of the options enclosed in 
parentheses. Each option is described below. 


A or Terminates the operation and CP/M-68K 
CTRL-C returns the system prompt. 


R Retries the operation. If the retry 
fails, the system reprompts with the 
option message. 
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Table A-1l. (continued) 


Message Meaning 


Cc Ignores the error and continues program 
execution. Be careful if you use this 
option. Program execution should not 
be continued for some types of 
programs. For example, if you are 
updating a data base and receive this 
error but continue program execution, 
you can corrupt the index fields and 
the entire data base. For other 
programs, continuing program execution 
is recommended. For example, when you 
transfer a long text file and receive 
an error because one sector is bad, 
you can continue transferring the 

. file. After the file is transferred, 
review the file, and add the data that 
was not transferred due to the bad 

sector. 


CP/M Disk write error on drive x 
Do you want to: Abort (A), Retry (R), 
or Continue with bad data (C)? 


BDOS error. This message indicates a hardware 
error. Specify one of the options enclosed in 
parentheses. Each option is described below. 


A or Terminates the operation and CP/M-68K 
CTRL-C returns the system prompt. 


R Retries the operation. If the retry 
fails, the system reprompts with the 
option message. 


Ignores the error and continues program 
execution. Be careful if you use this 
option. Program execution should not 
be continued for some types of 
programs. For example, if you are 
updating a data base and receive this 
error but continue program execution, 
you can corrupt the index fields and 
the entire data base. For other 
programs, continuing program execution 
is recommended. For example, when you 
transfer a long text file and receive 
an error because one sector is bad, 
you can continue transferring the 
file. After the file is transferred, 
review the file, and add the data that 

was not transferred due to the bad. 
sector. 
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Table A-L. (continued) 


Message Meaning 


CP/M Disk select error on drive x 
Do you want to: Abort (A), Retry (R) 


Disk error. There is no disk in the drive or 
the disk is not inserted correctly. Ensure 
that the disk is securely inserted in the 
drive. If you enter the R option, the system 
retries the operation. If you enter the A 
option or CTRL-C the program terminates and 
CPM~68K returns the system prompt. 


CP/M Disk select error on drive x 


Disk error. The disk selected in the command 
line is outside the range A through P. CP/M- 
68K can support up to 16 drives, lettered A 
through P. Check the documentation provided by 
the manufacturer to find out which drives your 
particular system configuration supports. 
Specify the correct drive code and reenter the 
command line. 


DIRECTORY FULL 
ED error. There is not enough directory space 
for the file being written. — 


You can use the 0Xfilespec command to erase any 
unnecessary files on the disk without leaving 
the editor. Alternatively, you can save the 
contents of the memory buffer on another disk 
with the command, BéXfilespec, where filespec 
is a file on a different drive. You can then 
quit the edit. If you reedit the file, the 
output should be placed on a different drive 
with the command, ED filespec d:, where d: is a 
valid drive name other than the drive 
containing the source file. 


You can read the file saved with the Rfilespec 
command. Caution, part of the file may not be 
in the memory buffer when you save it (if you 
have not appended the whole file or if you have 
issued any W commands). 
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Table A-1l. (continued) 
Message Meaning 
| DISK FULL 


ED error. There is not enough disk space for 
the output file. This error can occur on the 
W, E, H, or X commands. If it occurs with the 
X command you can repeat the command, prefixing 
the filename with a different drive. Otherwise 
you can try the recovery methods described 
above under the Directory Full error. 


sam A ca 


Disk select error on Destination 
Disk select error on Source 
ERROR 


BDOS, COPY, INIT error. The disk selected in 
the command line is not supported by CP/M-68K. 
CP/M~68K can support up to 16 drives, lettered 
A through P. Check the documentation provided 
by the manufacturer to find out which drives 
your particular system configuration supports. 
Specify the correct drive code and reenter the 
command line. 


BAD PARAMETER 


PIP error. The command contains an illegal 
Parameter. Refer to the section in this User's 
Guide on the PIP command for an explanation and 
listing of the PIP command parameters. Reenter 
the command with a valid parameter. 
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Table A-l. (continued) 


Message Meaning 


ERROR: CLOSE FILE - { filespec} 


PIP error. The output file specified in the 
previous PIP command cannot be closed. This 
message indicates a fatal error in the internal 
logic of PIP. Contact the place you purchased 
you system for assistance. You should provide 
the information below. 


e Indicate which version of the operating 
system you are using. 


Describe your system's hardware 
configuration. 


Provide sufficient information to reproduce 
the error. Indicate which program was 
running at the time the error occurred. If 
possible, you should also provide a disk with 
a copy of the program. 


ERROR: DESTINATION IS R/O, DELETE (Y/N)? 


PIP error. The destination file specified in a 
PIP command already exists and it is Read-Only. 
If you type Y, the existing file is deleted and 
replaced with the file specified in the PIP 
command. If you do not want to delete the 
existing file, type N and reenter the PIP 
command with a different destination file 
specification: either specify a new filename, 
or direct the destination file to a different 
disk. This message can be avoided by using the 
Woption. Refer to the section of this User's 
Guide on the PIP command for a discussion and 
list of the PIP options. 


ERROR: DISK READ - { filespec} 


PIP error. PIP can not read the input file 
indicated by the variable, filespec. This 
message indicates a bad disk. Ensure that the 
disk is in in place and retry the operation. 
If the error persists, the disk is bad and must 
be replaced. COPY or PIP as much of the bad 
disk as possible, or use your back-up disk, if 
you maintained one, to replace the lost files. 
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Table A-l. (continued) 
Message Meaning 
ERROR: DISK WRITE - { filespec} 


PIP error. The disk to which PIP is writing is 
full. The file indicated by the variable, 
filespec, was not copied. Reenter the PIP 
command line and redirect the output to another 
disk, if possible. If you do not have another 
disk available, you must erase unnecessary 
files, if any, or replace the disk before you 
reenter the PIP command line. 


ré 


FILE NOT FOUND - { filespec} 


PIP error. The input file indicated by the 
variable, filespec, does not exist, or the 
drive code or user number is incorrect. Ensure 
that you are typing the correct filename and 
drive code, and that you are in the correct 
user number or have specified the correct user 
number in the option brackets before you 
reenter the PIP command line. P 


BEX RECORD CHECKSUM - {filespec} | - 


PIP error. A hex record checksum error was 
encountered during the transfer of a hex file. 
This message indicates a corrupted or truncated 
hex file. ReCOPY or PIP the hex file from your 
back-up disks, if possible. If you do not have 
a back-up, you must ERAse the bad file and 
recreate it. 


INVALID DESTINATION 


PIP error. The destination specified in your 
PIP command is illegal. You have specified an 
input device as a destination, or used a 
wildcard file specification. Respecify the PIP 
command with an output device or a specific 
file as the destination. Refer to the section 
of this User's Guide on the PIP command for a 
discussion of the valid PIP destinations. 
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Table A-l. (continued) 


Message Meaning 


INVALID FORMAT 


PIP error. The format of your PIP command is 
illegal. Refer to the section of this User's 
Guide on the PIP command for the correct 
syntax. 


INVALID HEX DIGIT - { filespec} 


PIP error. An invalid hex digit has been 
encountered while reading a hex file. MThis 
message indicates a truncated or corrupted hex 
file. ReCOPY or PIP the file from your backup 
disk. If you do not have a backup, you must 
ERAse the bad file and recreate it. 


INVALID SEPARATOR 


PIP error. You have placed an invalid 
character for a separator between two input 


filenames. Reenter the PIP command line using 
a comma as the separator between the input 
filenames. 


INVALID SOURCE 


PIP error. The source specified in your PIP 
command is illegal. You have specified an 
output device as a source or used a wildcard 
filename. Reenter the PIP command line with an 
input device or a specific filename as the 
source. Refer to the section of this User's 
Guide on PIP for a discussion of the legal 
sources for a PIP command. 


ERROR: INVALID USER NUMBER 


PIP error. You have specified a user number 
greater than 15. User numbers are in the range 
0 to 15. Reenter the PIP command line using a 
valid user number. 
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Table A-l. (continued) 
Message Meaning 


NO DIRECTORY SPACE - {filespec} 


PIP error. The disk to which PIP is writing 
has no directory space available. 


ERAsSe unnecessary files, if any, or replace the 
disk before you reenter the PIP command line. 


ERROR: QUIT MOT FOUND 


PIP error. The string argument to a Q 

' parameter was not found in your input file. 
Ensure that you typed the correct string and 
retry the operation. This error can also occur 
when entering the Q option from the CP/M-68K 
command line. CP/M-68K translates everything 
in the command line into upper-case. To avoid 
this problem, enter the Q option from inside 
PIP. Enter PIP, and wait for the * prompt 
before entering the file specifications and Q 
option. 


ERROR: START NOT FOUND 


PIP error. The string argument to an § 
Parameter could not be found in the source 
file. Ensure that you are typing the correct 
string and retry the operation. This error can 
also occur when entering the S option from the 
CP/M-68K command line. CP/M-68K translates 
everything in the command line into upper-case. 
To avoid this problem, enter the S option from 
inside PIP. Enter PIP, and wait for the * 
prompt before entering the file specifications 
and S option. 


UNEXPECTED END OF HEX FILE - {filespec} 


PIP error. The last hex record was not as long 
as the character count indicated. The hex file 
is truncated. ReCOPY or PIP the truncated file 
from your back-up disk. If you do not have a 
back-up, you must ERAse the bad file and 
recreate it. 
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Message Mean ing 


USER ABORTED 


ERROR: 


ERROR: 


Table A-1. (continued) 


PIP error. You aborted a PIP operation by 
entering a CTRL-C or by pressing a key. I£ you 
did not intend to abort the operation, you must 
reenter the PIP command line. 


VERIFY - [filespec} 


PIP error. When copying with the V option, PIP 
found a difference when rereading the data just 
written and comparing it to the data in its 
memory buffer. This indicates a bad disk or a 
hardware error. Retry the operation. If the 
error persists, insert a new disk and reenter 
the PIP command line. If the error still 
persists, check the hardware. 


Extraneous argument ignored argument? 


COPY error. The command line contains too many 
arguments. The extraneous arguments are 
indicated by the variable ,arguments. The 
command was carried out up to, bat not 
including, the extraneous arguments. Refer to 
the section in this User's Guide on COPY for 
the correct syntax of the COPY command line. 
Reenter the command line with the correct 
syntax for the remaining arguments. 


File already exists 
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REN error. The name specified in the command 
line as the new filename already exists. Use 
the ERA command to delete the existing file if 
you wish to replace it with the new file. If 
not, select another filename and reenter the 
REN command line. 
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Table A-l. (continued) 


Message Mean ing 


FILE IS READ/ONLY 


ED error. A Read-Only file cannot be edited 
with the ED command: ED filespec. The command, 


ED inputfilespec outputfilespec, should be used 
instead. 


FILE NOT FOUND 
FILE NOT FoumD - {filespec} 


ED, STAT error. ED or STAT could not find the 
file indicated by the variable, filespec. 
Check the filename, drive code and user number 
before you reenter the command line. 


FILENAME REQUIRED 


ED error. The ED command was typed without a 

filename. Reenter the ED command followed by 

| the name of the file you wish to edit or 
create. 


Formatting Error 


bad disk or a hardware error. Retry the 
operation. If the error reoccurs, replace the 
Gdisk with a new disk. If the error persists, 
look for a hardware error. Contact your 
! technical support personnel or the place you 
purchased your system for assistance. 


j 
| FORMAT error. This message indicates either a 
| 


insufficient memory or bad file header 


Cccp error. This error could result from one of 
three causes: . 


! 
@e The file is not a valid executable command 
| 


e The program is too large for the available 
memory. 


e The program is linked to an absolute location 
in memory that cannot be used. 
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Table A-1l. (continued) 
Meaning 


Ensure that you are requesting the correct 
file. This error can occur when you enter the 
filename before you enter the command for a 
utility. Check the appropriate section of this 
User's Guide or the CP/M-68K Programmer's Guide 
for the correct command syntax before you 
reenter the command line. If-you are trying to 
run a program when this error occurs, the 
program file may have been corrupted. 
Reassemble or recompile the source file and 
relink it before you reenter the command line. 


Add more memory boards to the system 


' configuration, or rewrite the program to use 


less memory. 


The program must be made relocatable, or linked 
to a usable memory location. The BDOS Get/Set 
TPA Limits Function. (63) returns the high and 
low boundaries of the memory space that is 


_available for loading programs. See the CP/M- 


68K Programmer's Guide for more information on 


Function 63. 


INVALID ASSIGNMENT 


USE: STAT 


INVALID FI 


D: FILENAME . TYP {SIZE} [RO] [RW] [SYS] OR (PIR) 


STAT error. An invalid file assignment was 
attempted. The error message is followed by 
the correct syntax and a list of the valid file 
assignments. Refer to the section of this 
User's Guide on the STAT command for a 
discussion of file status assignments. Specify 
a valid file assignment and reenter the STAT 
command line. 


error. The filename specified is too long, 
or a delimiter was used as the first character. 
Filenames cannot be longer than eight 
characters. Refer to the section of this 
User's Guide on naming files for a list and 
description of the delimiters that cannot be 
used as the first character in a filename. 
Correct the filename and reenter the ED command 
line. 
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Message 


Table A-l. (continued) 


Meaning 


Invalid or missing drive code 


Ho file 


NO MEMORY 


FORMAT error. The FORMAT command line is 
either missing a drive code specification, or 
the drive specified is not supported by the 


BDOS. CP/M-68K can support up to 16 drives, 
lettered A through P. Check the documentation 
provided by the manufacturer to find out which 
drives your particular system configuration 
supports. Specify the correct drive code and 
reenter the command line. 


ccP, COPY, ERA, REN error. The filename 
specified in the command line does not exist. 
Ensure that you use the correct filename and 
reenter the command line. 


ED error. There is not enough space in 
available memory to create the buffer that ED 
requires to edit a file. Contact your 
technical support personnel or place of 
purchase for assistance. This problem can 
cecur when ED is absolutely linked too high in 
the TPA to allow for the buffer. ED needs 4K 
of memory at a location immediately higher in 
memory than itself for a buffer. Relink ED to 
a lower location. If ED is not linked too 
high, reconfigure the TPA of your system, if 
possible, by eliminating some system 
extensions. If it is not possible to 
reconfigure the TPA, additional memory boards 
must be added to the system configuration to 
run ED. 


No wildcard filenames 


CCP, REN error. The command specified in the 


command line does not accept wildcards in file 
specifications. Response: Retype the command 
line using a specific filename. 
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Table A-l. (continued) 


Message Meaning ~ 


OUTPUT FILE EXISTS, ERASE IT 


ED error. This error occurs when placing the 
destination file on a different disk than the 
source. The destination filename already 
exists on the receiving disk. The existing 
file should be erased or another disk selected 
to receive the output file. 


Program Load Error 


CCP error. This message indicates an undefined 
failure of the BDOS Program Load Function. See 
the CP/M-68K Programmer's Guide for more 
information on Function 59. Reboot the system 
and try again. If the error persists, then it 
is caused by an error in the internal logic of 
the BDOS. Contact the place you purchased your 
system for assistance. You should provide the 
following information: : 


e Indicate which version of the operating 
system you are using. 


Describe your system's hardware 
configuration. a a Ne 


Provide sufficient information to reproduce 
the error. Indicate which program was 
running at the time the error occurred. If 
possible, you should also provide a disk with 
a copy of the program. 


READ error > Track: t Sector: s 


COPY error. This message indicates a bad disk. 
The variable t is replaced with the number of 
the track where the error occurred. The 
variable s is replaced with the number of the 
bad sector. Retry the operation. If the error 
persists, use a new disk and COPY or PIP as 
many files as possible from the damaged disk. 
“a. If you cannot COPY or PIP a file, you must 
replace the file from your backup disk. If you 
have not maintained a backup disk, .you must 
recreate the lost file. Discard the damaged 
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fable A-1l. (continued) 


Message Meaning 


read error on program load 


CCP error. This message indicates a premature 
end-of-file. The file is smaller than the 
header information indicates. Either the file 
header has been corrupted or the file was only 
Partially written. If the program is one you 
have written, you must reassemble or recompile 
the source file, and relink it before you 
reenter the command line. If this message 
occurs any other time, and you have a backup 
copy of the program you were running, erase the 
program file and replace it from your backup 
files. If the error reoccurs, contact your 
technical support personnel or the place you 
purchased your system for assistance in 
locating the cause of the error. 


READ ONLY DRIVE STATUS NOT ALLOWED 
STAT error. Read-Only drive status is not 


supported by CP/M-68K. Assign each file on the 
disk Read-Only status individually. 


Select Error 


FORMAT, INIT error. This message indicates one 
ef three errors: 


@ The drive specified is not supported by your 
system. 


e The disk on the drive selected is not in 
place. 


@ A hardware error. 
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Table A-1. (continued) 


Message Mean ing 


CP/M-68K supports a maximum of 16 drives, 
lettered A through P. Check the documentation 
provided by the manufacturer to find out which 
-Of these drives your particular system 
configuration supports. Reenter the command 
line with a valid drive code specification. 


Check the disk. Ensure that it is securely in 
place and that the drive door is closed. 


If the disk is in place and you have selected a 
valid drive code, look for a hardware error. 
The error may have been caused by a loose 
connection or damaged drive. Contact your 
technical support personnel or the place you 
purchased your system for further assistance. 


Source and Destination must be different 


COPY error. The source and destination drives 
specified are the same. Reenter the COPY 
command line with a different drive for the 
source than for the destination. 


SUB file not found 


SUBMIT error. The file requested either does 
not exist, or does not have a filetype of SUB. 
Ensure that you are requesting the correct 
file. Refer to the section on the SUBMIT 
command in this User's Guide for information on 
creating and using submit files. 


Syntax: REN newfile-oldfile 


REN error. The syntax of the REN command line 
is incorrect. The correct syntax is given in 
the error message. Enter the REN command 
followed by a space, then the new filename, 
followed immediately by an equals sign and the 
name of the file you want to rename. 


ALL Informacion Presented Here is Freorietary cs 5irical Research 


CP/M-68K User's Guide 


fable A-l. (continued) 


DIR, ERA, TYPE, USER error. The command line 
contains too many arguments. The extraneous 
arguments are indicated by the variable, 
argument. Refer to the appropriate section in 
this User's Guide for the correct syntax for 
the command. Specify only aS many arguments as 
the command syntax allows and reenter the 
command line. Use a second command line for 
the remaining arguments if appropriate. The 
command may be repeated on one command line 
when separated by an exclamation point; for 
example, DIR a:!DIR b:. 


TOO MANY FILES 
TOO MANY ENTRIES YN INDEX TABLE 


STAT error. There is not enough memory for 
STAT to sort the files specified or more than 
512 files were specified. Move some files to 
another user number, or otherwise break the 
group of files into smaller groups before you 
reenter the STAT command line. For example, 
use a wildcard (*.typ) to run STAT on only 
those files with a certain filetype. 


option 


COPY error. The option specified in the COPY 
command line is unsupported. The only COPY 
options supported by CP/M-68K are a, for 
automatic, and v, for verify. Correct and 
reenter the COPY command line. . 


User # range is [0-15] 


CCP error. The user number specified in the 
command line is not supported by the BIOS. The 
valid range is enclosed in the square brackets 
in the error message. Specify a user number 
between 0 and 15 (decimal) when you reenter the 
command line. 
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Table A-1. (continued) 


Message Meaning 


Write Error 


FORMAT, INIT error. This message indicates 
either a bad disk or a hardware error. Retry 
the operation. If the error reoccurs, replace 
the disk with a new disk. T£ the error 
persists, look for a hardware error. The error 
may have been caused by a loose connection or 
damaged drive. Contact.your technical support 
personnel or the place you purchased your 
system for further assistance. 


WRITE error ----> frack: t Sector: s 


COPY error. This message indicates a bad disk. 
The variable t is replaced with the number of 
the track where the error occurred. The 
variable s is replaced with the number of the 
bad sector. Retry the operation. If the error 
persists, use a new disk and copy as many files 
as possible from the damaged disk. If you 
“cannot copy a file, you must replace the file 
from your backup disk. If you have not 
maintained a backup disk, you must recreate the 
lost file. Discard the damaged disk. 


End of Appendix A 
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Appendix B 
ASCII and Hexidecimal Conversions 


ASCII stands for American Standard Code for Information 
Interchange. The code contains 96 printing and. 32 non-printing 
characters used to store data on a disk. Table B-l defines ASCII 
symbols, then Table B-2 lists the ASCII and hexadecimal conversions. 
The table includes binary, decimal, hexadecimal, and ASCII 
conversions. 


Table B-l. ASCII Symbols 


— 


Mean ing 


Meee eee 


: ACK acknowledge FS file separator 
BEL bell GS group separator 
BS back space HT horizontal tabulation 
CAN cancel LF line feed e 
CR Carriage return NAK negative acknowledge 
: pe device control NUL null 
, DEL delete RS record separator 
: DLE data link escape SI shift in 
. EM end of medium — so shift out 
> ENQ ~ enquiry SOH start of heading 
5 EOT end of transmission SP space - pe 
; ESC escape STX start of text 
{ ETB end of transmission SUB substitute  - 
; ETX end of text SYN synchronous idle 
FF form feed US unit separator 


vertical tabulation 
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fable B-2. ASCII Convwersion Table 


0 NUL 


0000000 0 


0000001 1 1 SOH (CTRL~A) 

0000010 2 2 STX (CTRI-B) 

0000011 3 3 ETX (CTRL-C) 

0000100 4 4 EOT (CTRL-D) 

0000101 5 5 ENQ (CTRL-E) 

0000110 6 6 ACK (CTRL-F) 

0000111 7 7 BEL (CTRL~G) 

0001000 8 8 BS (CTRL-H) 

0001001 9 9 HT (CTRL-I) 

0001010 10 A LF (CTRL-J) 

0001011 11 B VI (CTRL~R) 

0001100 12 c FF (CTRI-L) 

0001101 13 D CR (CTRL-M) 

0001110 14 E SO (CTRL-N) 

0001111 15 F SI (CTRL-O) 

0010000 16 10 DLE (CTRL-P) 

0010001 17 a DCl (CTRL-Q) 

0010010 18 12 DC2 (CTRL-R) 

0010011 19° 13 DC3 (CTRL-S) 

0010100 20 14 DC4 (CTRL-T) 

0010101 21 15 NAK (CTRL-U) 

0010110 22 16 SYN (CTRL-V) 

0010111 23 17 ETB (CTRL-W) 

0011000 24 18 CAN (CTRL-X) 

0011001 25 19 EM (CTRL-Y) 

0011010 26 1A SUB (CTRL-Z) 

0011011 27 1B ESC (CTRL-[) 

0011100 28 1¢ FS (CTRI-\) 

0011101 29 1p GS (CTRLI-}) 

0011110 30 1E RS (CTRI-“*) 

0011111 31 1F US (CTRL-_) 

0100000 32 20 (SPACE) 

0100001 33 21 ! 

0100010 34 22 . 

0100011 35 23 : 

0100100 36 24 § 

0100101 37 25 $ 

0100110 38 26 & 

0100111 39 27 ' 

0101000 40 28 ( 

0101001 41 29 ) 

0101010 42 2A * 

0101011 43 2B + 

0101100 44 2c j 

0101101 45 2p - 

0101110 46 2E ; 

0101111 47 2F / 

0110000 48 30 0 
0110001 49 31 1 

0110010 50 32 2 


Table B—-2. (continued) 


0110011 
0110100 
0110101 
0110110 

o1Lo1l1 
0111000 
0111001 
0111010 
0111011 
0111100 
0111101 
0111110 
0111111 
1000000 
1000001 
1000010 
1000011 
1000 100 
1000101 
1000110 
1000111 
1001000 
1001001 
1001010 
1001011 
1001100 
1001101 
1001110 
1001111 
1010000 
1010001 
1010010 
1010011 
1010 100 
1010101 
1010110 
1010111 
1011000 
1011001 
1011010 
1011011 
1011100 
1011101 
: 1011110 
= LOLI 
1100000 
1100001 
1100010 
1100011 
1100100 
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fable B-2. (continued) 


[aexaaecine? [SH 
1100101 65 

1100110 , 
1100111 
1101000 
1101001 
1101010 
1101011 
1101100 
1101101 
1101110 
1101111 
1110000 
1110001 
1110010 
1110011 
1110100 
1110101 
1110110 
1110111 
1111000 
1111001 
1111010 
1111011 
1111100 
1111101 
1111110 
1111111 
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End of Appendix B 


Appendix C 
File Types 


CP/M-68K identifies every file by a unique file specification, 
which consists of a drive specification, a filename, a filetype, and 
an optional password. The filetype is an optional three-character 
ending separated from the filename by a period. The filetype 
generally indicates a special kind of file. The following table 
lists common filetypes and their meanings. 


: Table C-1. Common Filetypes 


Assembly language source file; the CP/M-68K 
Assembler assembles or translates a type .S 
file into machine language. 

Back-up file created by text editor; the editor 
renames the source file with this filetype to 
indicate that the original file has been 
processed. The original file stays on disk as 
the back-up file, so you can refer to it. 
Program source file written in the C language. 
68000 executable file. 

Header files for C language programs. 

Program file in hexadecimal format. 


Compiled or assembled object files. 


Printable file displayable on console or 
printer. 


Relocatable file produced by LO68 when the -R 
option is used. REL files may be converted to 
-68K files by using the RELOC utility. RELOC 
is explained in the CP/M-68K Programmer's 
Guide, 
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Table C-1. (continued) 


Filetype required for submit file containing 
one or more CP/M-68K commands. The SUBMIT 
program executes commands in files of type SUB, KJ 


providing a batch execution mode for CP/M-68K. 


System file for CP/M~68K. 


Temporary file which is inaccessible by user. 


End of Appendix C 


Appendix D 
CP/M-68K Control Character Summary 


Table D-1. CP/M-68K Control Characters 


Terminates executing transient utility program. 
Also terminates DIR, DIRS, SUBMIT, and TYPE 
Built-in programs in progress. When entered as 
first character in a command line or during the 
execution of the above-mentioned programs, 
causes a warm start and the redisplay of the 
system prompt. (Please see Section 4.4 for a 
discussion of warm start.) 


Forces a physical carriage return but does not 
send the command line to CP/M-68K. Moves the 
cursor to the beginning of the following line 
without erasing your previous input. 


Deletes a character and moves the cursor left 
one character position. 


Moves the cursor. to the next tab stop. Tab 
stops are automatically set at each eighth 
column. Has the same effect as the TAB key. 


Moves the cursor to the left of the current 
line and sends the command line to CP/M-68K. 
Has the same effect as a carriage return 
keystroke. 


Moves the cursor to the left of the current 
line and sends the command line to CP/M-68K. 
Has the same effect as a carriage return 
keystroke. 


Echoes all console activity to the printer. 
You can use CTRL-P after you halt scrolling 
with CTRL-S. A second CTRL-P ends printer 
echo. If your system is not connected to a 
Printer, a CTRL-P can cause your system to 
hang, requiring a cold start, that is a 
complete resetting of your hardware and. 
software. (Please Section 1.1 for a description 
of a cold start.) 


Restarts screen scrolling after a CTRL-S. 
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fable D—-1l. (continued) 


Types a # at the current cursor location, moves 
the cursor to the next line, and retypes any 
partial command you have typed so far. 


Stops screen scrolling. If a display scrolis 
by too fast for you to read it, type CTRL-S. 
CTRL-Q restarts screen scrolling. 


Discards all the characters in the command line 
that you typed so far, types a # at the current 
cursor position, and moves the cursor to the 
next command line. 


Discards all the characters in the command line’ 
that you typed so far and moves the cursor back 
to the beginning of the current lihe. 


End of Appendix D 
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Appendix E 
User's Glossary 


ambiguous filename: Filename that contains either of the CP/M-68K 
wildcard characters, ? or *, in the primary filename or the filetype 
Or both. When you replace characters in a filename with these 
wildcard characters, you create an ambiguous filename and can easily 
reference more than one CP/M~-68K file in a single command line. See 
Section 2 of this manual. 


applications program: Program that needs an operating system to 
provide an environment in which to execute. Typical applications 
programs are business accounting packages, word processing (editing) 
Programs and mailing list programs. 


argument: Symbol, usually a letter, indicating a place into which 
you can substitute a number, letter or name to give an appropriate 
meaning to the formula in question. 


ASCII: The American Standard Code for Information Interchange is a 
standard code for representation of numbers, letters, and symbols. 
An ASCII text file is a file that can be intelligibly displayed on 
the video screen or printed on paper. See Appendix A. 


attribute: File characteristic that can be set to on or off. 


back-up: Copy of a disk or file made for safe keeping, or the 
creation of the disk or file. 


bit: Switch in memory that can be set to on (1) or off (0). Bits 
are grouped into bytes. 


block: Area of disk reserved for a specific use. 


bootstrap: Process of loading an operating system into memory. 
Bootstrap procedures vary from system to system. The boot for an 
operating system must be customized for the memory size and hardware 
environment that the operating system manages. Typically, the boot 
is loaded automatically and executed at power up or when the. 
computer is reset. Sometimes called a cold start. 


buffer: Area of memory that temporarily stores data during the 
transfer of information. 


built-in commands: Commands that permanently reside in memory. 
ae They respond quickly because they are not accessed from a disk. 


byte: Unit of memory or disk storage containing eight bits. 
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command: Elements of a CP/M-68K command line. In general, a CP/M~ 
68K command has three parts: the command keyword, the command tail, 
and a carriage return. 


command file: Series of coded machine executable instructions 

. stored on disk as a program file, invoked in CP/M-68K by typing the 
command keyword next to the system prompt on the console. The CP/M- 
68K command files generally have a filetype of 68K. Files are 
either command files or data files. Same as a command program. 


command keyword: Name that identifies an CP/M-68K command, usually 
the primary filename of a file of type 68K, or a built in command. 
The command keyword precedes the command tail and the carriage 
return in the command line. 


command syntax: Statement that defines the correct way to enter a 
command. The correct structure generally includes the command 
keyword, the command tail, and a carriage return. A syntax line 
usually contains symbols that you should replace with actual values 
when you enter the command. 


command tail: Part of a command that follows the command keyword in 
the command line. The command tail can include a drive 
specification, a filename and/or filetype, and options or 
Parameters. Some commands do not require a command tail. 


concatenate: Term that describes one of PIP's operations that 
copies two or more separate files into one new file in the specified 
sequence. 


console: Primary input/output device. The console consists of a 
listing device such as a screen and a keyboard through which the 
user communicates with the operating systemor applications program. 


control character: Nonprinting character combination that sends a 
simple command to CP/M-68K. Some control characters perform line 
editing functions. To enter a control character, hold down the 
CONTROL key on your terminal and strike the character key specified. 
See Appendix D. 


Cursor: One-character symbol that can appear anywhere on the 
console screen. The cursor indicates the position where the next 
keystroke at the console will have an effect. 


Gata file: Nonexecutable collection of similar information that 
generally requires a command file to manipulate it. 


default: Currently selected disk drive and user number. Any 
command that does not specify a disk drive or a user number 
references the default disk drive and user number. When CP/M-68K is 
first invoked, the default disk drive is drive A, and the default 
user number is 0, until changed with the USER command. 
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delimiter: Special characters that separate diitferent items in a 
command line. For example, in CP/M-68K, a colon separates the drive 
specification from the filename. A period separates the filename 
from the filetype. Brackets separate any options from their command 
or file specification. Commas separate one item in an option list 
from another. All of the above special characters are delimiters. 


directory: Portion of a disk that contains entries for each file on 
the disk. In response to the DIR command, CP/M-68K displays the 
filenames stored in the directory. 


DIR attribute: File attribute. A file with the DIR attribute can 
be displayed by a DIR command. 


disk, diskette: Magnetic media used to store information. 
Programs and data are recorded on the disk in the same way that 
Music is recorded on a cassette tape. The term diskette refers to 
smaller capacity removable floppy diskettes. Disk can refer toa 
diskette, a removable cartridge disk or a fixed hard disk. 

disk drive: Peripheral device that reads and writes on hard or 
floppy disks. CP/M-68K assigns a letter to each drive under its 
control. For example, CP/M-68K may refer to the drives in a four- 
drive system as A, B, C, and D. 


editor: Utility program that creates and modifies text files. An 
editor can be used for creation of documents or creation of code for 
computer programs. The CP/M-68K editor is invoked by typing the 
command ED next to the system prompt on the console; See ED in 
Section 6 of this manual. 


executable: Ready to be run by the computer. Executable code is a 
series of instructions that can be carried out by the computer. For 
example, the computer cannot execute names and addresses, but it can 
execute a program that prints all those names and addresses on 
mailing labels. 


execute a program: Start a program executing. When a program is 
cunning, the computer is executing a sequence of instructions. 


FCB: File Control Block. 


file: Collection of characters, instructions or data stored on a 
disk. The user can create files on a disk. 


Pile Control Block: Structure used for accessing files on disk. 
Contains the drive, filename, filetype and other information 
describing a file to be accessed or created on the disk. 


filename: Name assigned to a file. A filename can include a 


primary filename of 1-8 characters and a filetype of 0-3 characters. 
A period separates the primary filename from the filetype. 
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file specification: Unique file identifier. A complete CP/M-68K 
file specification includes a disk drive specification followed bya 
colan (dz), a primary filename of 1 to 8 characters, a period and a 
filetype of 0 to 3 characters. For example, b:example.tex is a 
complete CP/M-68K file specification. 


filetype: Extension to a filename. A filetype can be from 0 to 3 
characters and must be separated from the primary filename by a 
period. A filetype can tell something about the file. Certain 
programs require that files to be processed have certain filetypes. 
See Appendix C. 


floppy disk: Flexible magnetic disk used to store information. 
Floppy disks come in 5 1/4 and 8 inch diameters. 


hard disk: Rigid, platter-like, magnetic disk sealed in a 
container. A hard disk stores more information than a floppy disk. 


hardware: Physical components of a computer. 


hex file: ASCII-printable representation of a command (machine 
language) file. 


hexadecimal notation: Notation for the base 16 number system using 
the symbols 0,1,2,3, 4, 5, 6, 7, 8, 9, A, B, C, D, E, and F to 
represent the sixteen digits. Machine code is often converted to 
hexadecimal notation because it can be easily represented by ASCII 
characters and therefore printed on the console screen or On paper. 
See Appendix B. 


input: Data going into the computer, usually from an operator 
typing at the terminal or by a program reading from the disk. 


imterface: Object that allows two independent systems to 
communicate with each other, as an interface between hardware and 
software in a microcomputer. 


T/O: Abbreviation for input/output. 
keyword: See command keyword. 


kilobyte: 1024 bytes denoted as 1K. 32 kilobytes equal 32K. 1024 
kilobytes equal one megabyte, or over one million bytes. 


list dewice: Device such as a printer onto which data can be listed 
or printed. 


logged in: Made known to the operating system, in reference to 
@rives. A drive is logged-in when it is selected by the user or an 
executing process, and remains selected or logged in until you 
change disks in a floppy disk drive or enter CTRL-C at the command 
level. 
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logical: Representation of something that may or may not be the 
same in its actual physical form. For example, a hard disk can 
occupy one physical drive, and yet you can divide the available 
storage on it to appear to the user as if it were in several 
different drives. These apparent drives are the logical drives. 


megabyte: Over one million bytes; 1024 kilobytes. See byte, 
kilobyte. 


microprocessor: Silicon chip that is the Central Processing Unit 
(CPU) of the microcomputer. 


operating system: Collection of programs that supervises the 
cunning of other programs and the management of computer resources. 
An operating system provides an orderly input/output environment 
between the computer and its peripheral devices. It enables user- 
written programs to execute easily. 


option: One of many parameters that can be part of a command tail. 
Use options to specifiy additional conditions for a command's 
execution. 


output: Data that the processor sends to the console or disk. 


parameter: Value in the command tail that provides additional 
information for the command. Technically, a parameter is a required 
element of a command. 


peripheral devices: Devices external to the CPU. For example, 
terminals, printers and disk drives are common peripheral devices 
that are not part of the processor, but are used in conjunction with 
it. 


physical: Actual hardware of a computer. The physical environment 
varies from computer to computer. 


primary filename: First 8 characters of a filename. The primary 
filename is a unique name that helps the user identify the file 
contents. A primary filename contains 1 to 8 characters and can 
include any letter or number and some special characters. The 
primary filename follows the optional drive specification and 
precedes the optional filetype. 


progran: Series of specially coded instructions that performs 
specific tasks when executed by a computer. 


prompt: Any characters displayed on the video screen to help the 
user decide what the next. appropriate action is. A system prompt is 
a special prompt displayed by the operating system. The system 
prompt indicates to the user that the operating system is ready to 
accept input. The CP/M-68K system prompt is an alphabetic character 
followed by an angle bracket. The alphabetic character indicates 
the default drive. Some applications programs have their own 
special system prompts. 
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Read-Only: Attribute that can be assigned to a disk file. Every 
file and drive is either Read-Only or Read-Write. When a file is 
set to Read-Only, you can read from that file but not write any 
changes to it. The default setting is Read-Write. Any error in 
resetting the disk or changing media automatically sets the drive to 
Read-Only until the error is corrected. 


Read-Write: Attribute that can be assigned to a disk file. The VY 
Read-Write attribute allows you to read from and write to a specific 
Read-Write file so marked. See Read-Only. 

record: Collection of data. A file consists of one or more records 
stored on disk. An CP/M-68K record is 128 bytes long. 

RO: Abbreviation for Read-Only. 

RW: Abbreviation for Read-Write. 

sector: Portion of a disk track. There are a specified number of 
sectors on each track. 

software: Specially coded programs that transmit machine readable 
instructions to the computer, as opposed to hardware, which is the 
actual physical components of a computer. 

‘pource file: ASCII text file that is an input file for a processing 
program, such as an editor, text formatter, or assembler. 

syntax: Format for entering a given command. 


system attribute: A file attribute. You can give a file the system 
attribute by using the SYS option in the STAT command. A file with 

the SYS attribute is not displayed in response to a DIR command; you 

must use DIRS to view a directory of files having the system 

attribute. (See Section 5.) 


system prompt: Symbol displayed by the operating system indicating 
that the system is. ready to receive input. See prompt. 


terminal: See console. 


track: Concentric rings dividing a disk. There are 77 tracks on a 
typical eight inch floppy disk. 


turn-key application: Application designed for the non computer- 
oriented user. For example, a typical turn-key application is 
designed so that the operator needs only to turn on the computer, 
insert the proper program disk and select the desired procedure from 
a selection of functions (menu) displayed on the screen. 
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upward-compatible: Term meaning that a program created for the 
previously released operating system (or compiler, etc.) runs under 
the newly released version of the same operating system. 


user number: Number assigned to files in the disk directory so that 
different users need only deal with their own files and have their 
own directories even though they are all working from the same disk. 
In CP/M-68K, files can be divided into 16 user groups. 


utility: Tool. Program that enables the user to perform certain 
operations, such as copying files, erasing files, and editing files. 
Utilities are created for the convenience of programmers and users. 


wildcard characters: Special characters .that match certain 
specified items. In CP/M-68K there are two wildcard characters, ? 
and *, The ? can be substituted for any Single character in a 
filename, and the * can be substituted for the primary filename or 
the filetype or both. By placing wildcard characters in filenames, 
the user creates an ambiguous filename and can quickly reference one 
or more files. 


End of Appendix E 
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$$$ file, 50 
68K, 8 
tn (Through Line Number) Command, 


A 


A (Append) command, 82 

abort a copy operation, 54 

access modes, 66-68 

active user numbers, 70 

assign physical device to 
logical device, 71 

attributes, 67 

AUXI:, 17 

AUXO:, 17 

AXI:, 54 

AXO, 54 


B (Beginning/Bottom) 
command, 87 

back-up disks, 3-4 

basic editing commands, 86 

booting the system, 1 — 

bytes, 66 


Cc 


C (Character) command, 
character pointer, 85 
character transfer, 53 
cold start, 1 
combined-command line, 93 
combining files, 52 
command 

description, 28 

keyword, 2, 28 

line, 2 

mode, 91 

tail, 2 
CON:, 17, 54 
concatenation, 53 
control character, 2 
copy, 3 
COPY command, 4, 33~36 
copy files to and from 

auxiliary devices, 53 

CP, 85 
CTRL key, 2 
CTRL-E, 95 


87, 93 


Index 
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CTRL-Z, 53, 
cursor, 2 


34, 55, 


31, °95 


D 


D (Delete) Command, 89 
data files, 7 
default 
drive, 9 
user number, 52 
dest-filespec, 31 
DEV:, 71 
device names, 54 
dir, 37 
DIR (Directory) Command, 37 
66-68 
directory, 7, 12 
attribute, 66 
entries, 66 
space, 12 
verification, 67 
DIRS (System Directory) 
Command, 2, 37 


disk ; 


free space, 6 

space allocation, 67 
displaying disk status, 69 
Dn (delete characters) 

option, 57 

drive, 12 

specifier, 9-10, 25 
E 


E (echo) option, 5l, 58 
E (Exit) Command, 84 
ED, 7 
ED Command, 39 
ED 
error symbols, 
messages, 80, 
prompt, 80, 91 
syntax, 79 
editing, 94 
editors, 79 
end-of-file character, 53 
EOF:, 54 
ERA command, 44 


102 
94-96, 99, 
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F 


F (filter form-feeds) 
option, 58 
F (Find) command, 93 
FCB, 66 
file, 7 
attributes, 50 
categories, 8 
concatenation, 53 
specification, 25, 67 
filename, 25 
filetype, 8, 25 


G 


Gn option, 49, 50, 53, 56, 58 


H (Head of File) Commas: 
84, 94, 98 

H (hex data transfer) 
option, 58 


I 


I (ignore) option, 58 

I (Insert) command, 90 

input devices, 17 

input-output port, 71 

insert mode, 90 

Istring”Z (Insert String) 
Command, 91 


J 
J (Juxtapose) command, 95 
K 
K 


(Kill) command, 89 
kilobytes, 66 


L 


L (Line) command, 87, 93 
L (translate case) option, 58 
line editing controls, 91 
characters, 17 
line numbers, 82 
loading CP/M-68K, 1 
logical device names, 
long form of PIP, 51 
LST:, 17, 54 


17, 54, 71 
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M (Macro) command, 96 
memory buffer, 80, 82 
multiple command mode, 55 
Multiple file copy, 51 


N (add line numbers) option, 58 


n (Number) command, 88 
N Command, 94 
nh: (Line Number) Command, 92 
NUL:, 54 
numeric argument, 85 
O (object file transfer) 
option, 53, 58 
O (Original) Command, 98 
on-line 
disk, 12 
status, 69 
Options, 28 
output devices, 17 
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P (Page) Command, 92 
peripheral devices, 17 
physical device 

drivers, 71 

names, 70 
PIP, 7, 30 

command, 49 

messages, 52 

options, 50, 56 
Pn (set page length) option, 
pound sign argument, 85 
PRN:, 54 
program file, 


Q 


Q (Quit) command, 99 
Qs (quit copying) option, 60 


1, 7 


R 


R (read system files) 
option, 60 

R (Read) command, 97 

Read-Only 
attribute, 
files, 50 

Read-Write attribute, 

ready status, 12 


64, 66 
64, 66 
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67 


real file size, 


records, 66 

recovering from editing error 
conditions, 101 

66 


command, 62 
messages, 63 
repeated execution of ED 
commands, 96 
reset, 13 
RETURN key, 2 
RO, 64-68 
RW, 64-68 
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S (Substitute) command, 
set file access modes, 
short form of PIP, 50 
single file copy, 49 
SIZE, 67 
source file, 
square brackets, 


80, 82 


50, 56 


-.88 (Start copying) option, 59 


64-67 
28-30 


STAT command, 
syntax notation, 


System (SYS) attribute, 66-68 


system 
prompt, 
reset, 2 


2, 13 


T 
fT (Type) Command, 94 
tab characters, 77 
temporary file, 50, 
text editor, 7 

Text Transfer Commands, 82 
Tn (expand tabs) option, 60 
Type, 28 

TYPE command, 


88, 93, 
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77 
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U (translate case) option, 60 


U (upper-case translation) 
command, 91 

USER command, 52, 78 

user numbers, 70, 78 


‘wildcard characters, 


Vv 
V (verify) option, 51, 60 
VAL:, 70 


version number, lL 
virtual file size, 67 


Ww 


W (write over) option, 60 

W (write) command, 84 

W option, 50 

66 


ll, 26, 


x 


X (Transfer) Command, 96 
XSSSSSSS.LIB file, 97 


Zz 


Z (zero the parity bit) option, 
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